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Summary of Amendments 
for VSE/VSAM VSAM Logic, Volume 1 


Summary of Amendments 
for LY24-5191-1 
Release 2 


This major revision contains changes for the following 
items: 


e DASD Sharing: Users can share files and catalogs 
across VSE systems as well as across partitions 
through the use of the Access Method Services 
SHAREOPTIONS parameter. VSAM now uses the 
supervisor lock table/lock file and the LOCK and 
UNLOCK macros to determine whether a file can be 
opened by multiple users. (This function was formerly 
performed by the Look-Aside Table and by issuing 
USE and RELEASE macros.) 


¢ Catalog Management Improvement: The scanning 
method used by Catalog Management in retrieving 
catalog record fields (from the catalog field name 
dictionary) has been changed to reduce the path length 
for each scan and to reduce the number of scans 
required for a combination name. 


¢ Dynamic Files: Ifa file is defined with the 
NOALLOCATION parameter, space is not allocated 
to it until it is opened. VSAM Open invokes Catalog 
Management to allocate space of the requested class. 


e Default Volumes: Users can omit explicit volume lists 
in the DEFINE CLUSTER and DEFINE 
ALTERNATEINDEX commands if a default model 
exists for the component. Catalog Management 
generates a volume list from the default model. 


e¢ Partition/Processor Independence: Catalog 
Management generates a filename by removing the % 
and appending the partition-ID (partition independent 
file) or removing the %% and appending the 
processor-ID and model number (processor 
independent file). 


® DEDICATE/ORIGIN: For DEDICATE, Catalog 
Management searches the VTOC and assigns all 
available tracks or blocks to VSAM for suballocation. 
For ORIGIN, Catalog Management assigns space in 
the VTOC based on the value specified in the 
ORIGIN parameter, rather than requiring an explicit 
specification in the EXTENT statements. 


e Dynamic Assignment: Catalog Management does not 
require the user to specify device assignments 
(symbolic unit parameter in EXTENT statement). It 
requests the Supervisor to dynamically assign devices. 


e Space Management for SAM Feature: This manual 
documents hooks in VSAM Open/Close for the Space 
Management for SAM Feature. For information 
about the internal logic of that feature, refer to 
VSE/VSAM Space Management for SAM Feature 
Logic, LY24-5204. 


Various editorial changes are also included to improve the 
usefulness of this manual. 
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Preface 


This logic manual is one of three volumes providing detailed information 
about VSE/VSAM. The three volumes are: 


VSE/VSAM VSAM Logic, Volume 1: Catalog Management, Open/Close, 
DADSM, IIP, Control Block Manipulation, LY24-5191 


VSE/VSAM VSAM Logic, Volume 2: Record Management, LY24-5192 
VSE/VSAM Access Method Services Logic, LY24-5195 


Except for record management, this volume contains all VSAM logic docu- 
mentation. Specifically, the following topics are included: 


e Control block manipulation 

¢ OPEN/CLOSE 

e ISAM Interface 

e Catalog management 

e Catalog management services 
e DADSM 


VSE/VSAM VSAM Logic, Volume 2 documents record management, I/O 
management, buffer management and EOV logic. 


This manual is mainly intended for persons involved in program mainte- 
nance and for system programmers who are altering the program design. 
Logic information is not necessary for the operation of the programs de- 

scribed. 


This manual and the code it supports should be viewed as a maintenance 
set. This means that the module prologues and comments contain certain 
types of information and that this manual contains other kinds of informa- 
tion. Thus, the listings provide the description of the internal logic of 
modules, and the manual uses Method of Operations diagrams to show what 
the functions of VSAM are and how the modules work together to carry out 
those functions. The term data set is used in this manual instead of file to 
conform to the program listings. 


Effective use of this publication requires an understanding of system opera- 
tion, PL/S language, assembler language, and its associated macros. 


Organization of This Publication 


This publication is organized in the following manner: 
e Section 1. Introduction describes the major components of VSAM. 


e Section 2, Method of Operation contains HIPO diagrams describing the 
VSAM components documented in this volume. 


e Section 3. Program Organization describes the information contained in 
VSAM program listings and the relationship of the program structures 
to the issued macro. Flowcharts of catalog management modules are 
included. 


e Section 4. Directory contains lists of phases, components, modules, 
routines, catalog external entry points, and data areas. 


e¢ Section 5. Data Areas describes control blocks used by the VSAM 
components documented in this volume, and describes VSAM data, 
index, and catalog records. 


e¢ Section 6. Diagnostic Aids contains diagnostic aids, such as error codes. 
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Required Publications 


Related Publications 


Using This Publication 


e Glossary defines terms relevant to VSAM. 
e Index is a subject index to the publication. 


The following publications should be read and understood before using this 
publication: 


VSE/VSAM General Information, GC24-5143, explains basic VSAM- 
Extended concepts and facilities and how to use them. 


Using VSE/VSAM Commands and Macros, 8C24-5144, tells how to 
code VSAM macros in application programs and describes VSAM data 
management. Access Method Services commands and their use are also 
described. 


Other publications that may be of interest in conjunction with this manual 
are: 


VSE/VSAM Programmer’s Reference, SC24-5145, describes installation 
and operating procedures, sysgen information, storage estimates, debug- 
ging techniques, performance tips, and recovery procedures. 


VSE/VSAM Messages and Codes, SC24-5146, includes all messages and 
codes originated by VSAM and Access Method Services. 


VSE/VSAM VSAM Logic, Volume 2, LY24-5192, describes record 
management, I/O management, buffer management, and EOV logic. 


VSE/VSAM Access Method Services Logic, LY24-5195, documents the 
logic of Access Method Services. 


VSE/VSAM Space Management for SAM Feature Logic, LY24-5204 
documents the interface between that feature and VSAM open/close. 


This publication is designed to be used with the VSAM program listings. 
The diagrams in Method of Operation describe the major functions per- 
formed by VSAM; these diagrams are intended to be your key to a module 
name (and routine name, as appropriate) in the listing. See the Method of 
Operation chapter for a description of how to read these diagrams. For 
information on what is available in the program listings, see the chapter 
Program Organization. 


The module directory in the Directory chapter lists the modules by symbolic 
name (all of which start with IKQ, IIP, IGGO, $S or $$B) and contains page 
references to the appropriate method of operation diagram or program 
structure that applies to each module. If you wish to see how modules are 
grouped according to component (such as open, catalog, etc.) see the compo- 
nent directory. The routine directory, where relevant, further shows how the 
modules are subdivided into routines. 


The Directory chapter also contains the names of the catalog external entry 
points (which start with IGGP). These external entry points are cross- 
referenced in the module directory by module name. As a further aid, charts 
showing program flow for each catalog module are contained in the 
Program Organization chapter. The charts are numbered sequentially by an 
alphameric code that corresponds to the last two characters of the symbolic 
module name, for example, module IGGOCLAG is flowcharted in Chart 
AG. 
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The Index to this volume contains a list of all VSAM modules and indicates 
whether each is documented in Volume 1, Volume 2, or both. 
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Section 1. Introduction 


Virtual Storage Access Method (VSAM) is an access method used with 
direct-access storage to provide fast storage and retrieval of data. 


VSAM is divided into modules, which are logically grouped into the follow- 
ing components: 


Control block manipulation, which allows the user program to create, 
modify, display, and test the contents of some VSAM control blocks (the 
ACB, EXLST, and RPL, which are described under Data Areas in this 
publication), and to build or delete a VSAM resource pool. 


Open, which connects a user’s program to a VSAM data set and builds 
the control blocks required to permit the user to read from and write to 
the data set. 


ISAM interface, which allows the user program to issue ISAM macro 
instructions to process records in a VSAM data set. 


Catalog management, which writes and updates catalog records. Cata- 
log management processes the catalog to obtain information for Open, 
Close, end-of-volume, and Access Method Services. 


DADSM, which allows the system to maintain VTOC labels for data 
spaces. In VSAM, DADSM is used by the catalog to create and delete 
data spaces, both unique and nonunique. 


Record management, which reads and writes records in response to 
user-issued VSAM and ISAM macro instructions. This component also 
reads and writes records for the catalog management component. This 
component is documented in VSE/VSAM VSAM Logic, Volume 2. 


End of Volume, which mounts volumes and allocates space. End of 
Volume modifies the existing control blocks to reflect the newly mount- 
ed volumes and newly allocated space. This component is documented 
in VSE/VSAM VSAM Logic, Volume 2. 


Close, which disconnects a user’s program from a data set and releases 
the data set’s control blocks built by Open. Close also updates statistics 
in the VSAM catalog. 


Service aids, which enable program maintenance and Field Engineering 
personnel to obtain dumps, maintain VTOC labels, and load phases. 


For a list of the modules in these components, see the Directory in this 


publication. 


ree te 
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Section 2. Method of Operation 


Reading Method of Operation Diagrams 
Method of operation diagrams depict the internal functions of a program- 
ming system, in this case, an access method. The internal functions are 
categorized by the macro instructions issued by the user, such as the 
GENCB, MODCB, OPEN, GET, PUT, CLOSE and ENDREQ macro 
instructions. 


Diagram AB shows the basic organization of the method of operation 
diagrams according to the macro instructions mentioned above. References 
lead from the high-level charts showing subfunctions required to carry a 
request to its completion. 


Note the relationship of function (exemplified by the macro instructions) to 
component. Starting with an OPEN issued by the user, a logical progression 
is made from Open modules to supporting Catalog modules. When a record 
management macro instruction such as PUT is issued by the user, not only 
the Record Management modules are involved (which include modules that 
perform buffer and I/O management and end-of-volume processing) but 
the Catalog modules which, in turn, call upon the DADSM modules for 
space management. 


The diagrams contain three blocks of information: input, processing, and 
output. The left-hand side of the diagram shows the data that serves as 
input to the processing steps on the center of the diagram, and the right- 
hand side shows the data that is output from the processing steps. Input is 
anything significant that program processing steps refer to or get. Processing 
is the steps that support the function or subfunction represented by the 
diagram. Output is any significant change effected by a processing step, for 
example, register contents, or control blocks created or modified. The 
processing steps are numbered and the numbers correspond to notes, if any, 
on the pages following the appropriate diagram(s). If notes are given, they 
include references to modules, routines, and/or labels shown on the extreme 
right-hand side of the diagram. These references are your link to the pro- 
gram listings. Figure 2.1 shows the symbols used in these diagrams and 
describes their meaning. 


As an example of how to interpret a typical method of operation diagram, 
see page 2 of Diagram GA, which graphically depicts the CLOSE/TCLOSE 
functions. The left-hand side of the diagram shows the significant input 
required by the processing steps shown in the diagram. For example, regis- 
ter 0 points to a list of DTF pointers for an ISAM user and ACB pointers for 
a VSAM user. The data-set information in the ACB is input to steps 5 and 7 
in the processing portion of the diagram. The processing portion of the 
diagram shows the processing steps required to fulfill the function described 
by the diagram. Note that the function described by one diagram may be 
performed by one or more VSAM modules; that is, the diagrams not only 
show program flow, but show the subfunctions that are required to carry out 
the function and that are subsequently shown in separate diagrams. 


Note that some diagrams have more than one entry point. In Diagram GA, 
for example, there are three entry points: 


(1) at step 1 for an automatic Close, 
(2) at step 5 after a user-issued CLOSE macro 
(3) at step 7 after a user-issued TCLOSE macro 
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The notes provide details about the processing shown in the diagram. For 
example, note 5 tells what action the VSE Close Monitor takes (in step 5) 
when it examines the DTF-type field in the list of ACBs and DTFs passed 
by the user. The notes also name the modules and routines that perform the 
functions represented. 


The diagrams are numbered in a sequence that follows the pattern ccn, 
where the first character, in general, represents a part of VSAM such as 
catalog management, the second character represents a category within 
catalog management, and the number represents the first, second, third, etc., 
page of that particular diagram. Thus, DEI would be the first page (1) of 
the Locate function (E) for catalog management (D). See the list of dia- 
grams for details. 


DATA MOVE -- shows input and output of data to and from the 
processing steps 


FLOW OF ACTION -- shows the flow of action through the process- 
ing steps 


ERROR FLOW -- shows the flow of action in the case of an error or 
for unusual conditions. This symbol is normally used only in the 
steps where an error causes a change of flow. Further error proc- 
essing uses the normal! symbols for flow of action. 


POINTERS -- these are the interconnections between the control 
blocks and data areas 


REFERENCE INDICATOR -- means refer to this item 


1/0 INDICATOR -- used where arrows had to be interrupted, or 
where one input or output is used for several steps. Circles within 
one diagram with identical letters are regarded as being logically 
connected. 


ONPAGE CONNECTOR -- used together with the flow of action 
symbols to indicate a branch, within the same diagram, to the step 
number within the circle, regardless of whether the diagram is on 
more than one page. 


OFFPAGE CONNECTOR -- used for backward reference between 
diagrams. 


ADDRESS -- indicates, within control blocks, that this field contains 
the address of the specified field. 





Figure 2.1 Symbols used on method of operation diagrams 
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Diagram AA1. Method of Operation Contents 


VSAM 
overview 


See Diagram 
AB 


Control ISAM Catalog Catalog Record 


block 
manipulation 


interface management management DADSM management Close 


services 


See Diagrams See Diagrams See Diagrams See Diagrams See Diagrams See Diagrams See Diagram 
AC-Al BA-BD CA-CP DA-DM EA-ES FA-FH GA 


* See VSE/VSAM VSAM Logic, Volume 2 
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Diagram AB1. VSAM Overview 


Control block manipulation macros 
processing (see Diagrams AC1 and AD1) ACB, RPL, or EXLST 


User-issued VSAM 


GENCB macro Ee Build a new control block. 


SHOWC . 
Ri MODCB, SH Bor 4 , 
veetes meee a> Modify, display, or test a control block. 


User-supplied argu- 
Parameter List ment control entries 















Open processing (see Diagram BA1) 








Connects the user's processing program to its 


=> associated VSAM data set. 


: 


User-issued VSAM 
OPEN macro {SVC 2} 
VSAM user’s partition 






SN ee) 


User's VSAM Record management processing (See Vol. 2) 
data set 





User's record 
area 



















(closed or User-issued VSAM : 
Comes GET macro > Retrieve a record. 
ele eadaas bee as | ; 
ERASE macro User’s VSAM 
' =p Delete a record. deine 
F---------- > (open) 






PUT macro Me Store a new or updated record. 


coccccccct 
POINT macro j tinni 
ENDREQ macro Set or reset string positioning. 
ao 


POINT (or GET 
and PUT direct) 








User’s VSAM data 
set (open) 





User's record area 


Data record 


RPL User-issued VSAM 


ce 
paata A a aee BED disconnect the user's processing program from —— — — —- 
or automatic Oi its associated VSAM data set. | 


close 


Close processing (see Diagram GA1) 












User's VSAM 
data set (closed 
or sharable) 
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Diagram AC1. GENCB: Build a New Control Block 






















Modul 
cence Sr label 
Is an ACB, RPL, or EXLST requested? IKQGENOO 
Yes No OE Eo exit 
vA REGCBLEN 
/ ; 
- / P i Determine amount of storage needed to B5 
/ 7 satisfy request. 
User-supplied 7 | . 
argument control / a 33. \sauser area supplied? 
entries - Yes No 
Sault 
\~ 34. Is this request for an EXLST? BAI 
| No Yes (10) ane 
[ere | VON 
Enea \ | ; 
5. Is this request for an RPL? 


\ No Yes 


6. Its the request for more than one copy? 


Aliocation 
No Yes Unit 


7. Build an allocation unit and initialize its 


header. ® 





Notes for Diagram AC1 


1 The GENCB macro is issued to create an ACB, RPL, or EXLST 
dynamically. If an ACB, RPL, or EXLST has not been requested, an 
error exit is taken. 


2-3. The ACB and RPL are fixed-length control blocks but the EXLST 
length is variable. If a user area is supplied for an EXLST, this 
routine uses a minimum length of ten bytes to find out if the user 
area is large enough. If a user area is not supplied for an EXLST, this 
routine calculates the amount of space need for the EXLST and any 
copies the user requested. 


4-7 If only a single ACB is requested, and no user area is supplied, an 
allocation unit is built to contain an allocation unit header, an ACB, 
an AMBL, and as many RPLs and PLHs as indicated by the STRNO 
parameter. 
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Diagram AC2. GENCB: Build a New Control Block 
































Module 
R1 ; Gr abel 
. Is suballocation possible? Allocation Unit ee 
User-supplied Header 
argument control Yes No 
entries / 
iM 
. 9. Suballocate the RPL(s). mme>(12) 
N | 10. Obtain storage for control block c2c 
/ NN : : C4 
pa] Keyword // 11. Is user area targe aneag? Z (12) 
// A Control block area 
11 Yes No CO Error exit | 
// cB 
/ 12. Set up the control block with default values CB 
A in the contro! block area. 
/ 
7/| Argument control entry (ACE) processing 
User area / 
WA REGENTRY 
/ ; ; 
. Locate entry in keyword table associated 
Cantrelbiock sat 7 with the ACE keyword. 
| Keyword table 
Determine entry type. G1 
G6 
For an address-type entry, branch to routine GS 
pointed to by subtable entry to process the Control block 
address-type entry. 

Subtable For a bitstring-type entry, locate bitstring Mt 
entry in subtable. Control! block M4 
ee bits in keyword entry and place them N1 

—————| N4 
n pag: “Ge oe = 
Notes for Diagram AC2 
8-9. lf an RPL is requested for an ACB which is suballocated, and 
if there is sufficient space in the ACB’s allocation unit, the 
RPL is suballocated. 
10. The routine issues a GETVIS macro to obtain the required 
storage for any block for which a user area is not provided. 
12. The block is initialized to its‘default values. Information is 
subsequently added to the block as specified by the keyword 
entries. 
13. For the last argument entry, the high-order bit in the parameter 
list pointer is 1. 
14. Three types of entries are identified in the keyword table: 
address, bitstring, and normal. 
15. If the entry is an address type, the keyword table points to an 


offset in'thte subtable that contains a pointer to'a routine 
that generates information to be placed in the appropriate 
control block field. 


16-17. If the entry is a bitstring type, the keyword table points to a 
series of bit entries in the subtable. The indicated bits are placed 
in the block. 
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Diagram AC3. GENCB: Build a New Control Block 


ACE processing continued 











EXLST 
— > 18. For anormal-type entry in EXLST, reinitialize 
EXLST. EXLST 
Keyword entry —F 19. Move the exit address from the keyword 


— | entry into EXLST. | Or 


> 20. Fora normal-type entry in ACB or RPL, 
move user-supplied information from the 


keyword entry into control block. 





Return 


Notes for Diagram AC3 


18-19. The size of the EXLST is adjusted to the actual amount of space 
required to satisfy the user request. If the user-supplied area is 
not large enough, a return is made to the user. 


When the last keyword has been processed, any surplus space 
obtained by a GETVIS is reclaimed (surplus user-supplied space 
is not reclaimed). As each keyword is processed, the EXLST 

is checked to see if space is available at the proper offset for 
that keyword. If no slot is available, a GETVIS obtains addi- 
tional space, provided the space was originally obtained by a 
GETVIS. 


20. If the entry is a normal type, the value in the argument control 
entry is moved into the block. 


Module 
or label 


H1 
H5 


J1 
J3 


K1 
K3 


Licensed Material — Property of IBM Section 2. Method of Operation 


2.7 


Diagram AD1. MODCB, SHOWCB, TESTCB: Modify, Display, or Test 
a Control Block 













User-issued 
MODCB, 
SHOWCB 
or TESTCB 


1. Analyze the request and build a parameter 
list. 


2. Are control block and function type valid? 


Yes No 


. Perform requested function 


See Diagram AE, SHOWCB, 
Diagram AF, MODCB, 
or Diagram AG, TESTCB. 


Notes for Diagram AD1 


The MODCB, SHOWCB, and TESTCB macros are issued to modify, display, 
and test the ACB, RPL, or EXLST. 


The macros are analyzed by the macro IKQCB2. If this macro actually 
builds the parameter list, it can ensure that the parameters are valid. In 
this case, control is then passed to the module IKOQTMSF (F = fast = 
without diagnostics). 


(f the user provides a ready-built parameter list, the macro |KQCB2 cannot 
check the validity of the parameters and passes control to the module 
IKOQTMSD (D = diagnostic). 


Each module contains routines for processing all possible combinations 
of request and control blocks (such as SHOWCB for ACB, TESTCB for 
an RPL, etc.). 


2.8 


VSE/VSAM VSAM Logic, Volume | 


= 


o> Return 


User-supplied 
argument 
control entries 


Parameter 
List 
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Diagram AE1l. SHOWCB: Display a Control Block 





R1 


1. Is a control block specified? 
4 
7 Yes No |, >(11) 
an 


7 > 2. Is the control block at the given address the 
—_— “ge 
- type that was specified? 


\ | Yes No GOOE> Return [4] =e! 
OY 


ts the user’s area aligned on a fullword 
boundary? 


Yes No GOEE> Return nN i E 
$ [= Ce) 


Locate the next entry in the keyword table. 






User-supplied 
argument 
control entries 


Key word 


, R15 
Parameter list 





Alf entries handled? 
No Yes aE Return 


. Check the validity of the entry (IKQTMSD 
only). 








ACB, RPL \ | 7. Entry valid? 


or EXLIST \ 
| \ Yes No pons 4 Return 


8. Locate the requested control block field. 


Notes for Diagram AE1 


The processing shown here can take place in module IKQTMSF or 
IKQTMSD (see notes for Diagram AD). 


The subroutines, which have identical names in both modules, are: 


Block Label 

ACB SHOWACB 
RPL SHOWRPL 
EXLST SHOWEXL 
None SHOWNOB 
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Diagram AE2. SHOWCB: 


Display a Control Block 





ACB, RPL, / 
or EXLST / 


Ri 






Parameter list 
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12. 
\ 13. 


14. 
15, 


Is the user’s area large enough for the 
requested field? 


Yes No Return 


i 


fi 


Move the requested field to the user's area. 


Is the user’s area aligned on a fullword 
boundary? 


Yes No Return 


; 


Locate the next entry in the keyword table. 


All entries handled? 


{ 


No Yes Return 


Check validity of entry (IKQTMSD only). 


Entry valid? 
Yes No => Return 
. User's area large enough? 


Yes No Return 


; 


Move standard control block length into 
user's area. 


(Ba Y> 


R15 RO 


User's area 


R15 RO 


RO 


Ris 


| User's area 
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Diagram AF1. MODCB: Modify a Control Block 


R1 





User-supplied 











t aes 
Parameter list Beal eating > 1. Does the control block at the specified address 
ae. match the specified control block type? 
~ RIS RO 
Yes No o> Return 
. (ee a Ce 


“XN 
\ “XN 
\V ~ , . 
\ \Cs) 2. Which control block is to be modified? 
\ ACB or RPL EXLST mmm) 
















\ os Modify ACB or RPL R15 RO 
VANS Ce] 
\ \ 3. Is the control block in use? 
Keyword table \ 
a, ON No Yes > Return 


‘ 4. Locate the next entry in the keyword tabie. 


\ \ 6. All entries handled? 


No Yes ——> Return pa 


6. Is the entry valid (IKQTMSD only)? 


Subtable 


\ >> 
\ Yes No Return Modified 
% v ACB or RPL 
g! If this is a ‘‘normal’’ keyword, move the 
\ argument entry into the control block. 
ACB or RPL | 


7 N 
NS, J 


If this is a ‘“bitstring’’ keyword, modify 


a 
——> 
© | # the control block bit by bit, according 
7 to the subtable information. 





Notes for Diagram AF1 


The processing shown here can take place in module IKQTMSF or 
IKOTMSD (see notes for Diagram AD). 


The subroutines used for MODCB, which have identical names in both 


modules, are: 

Block Label 
ACB MODACB 
RPL MODRPL 


EXLST MODEXL 
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Diagram AF2. MODCB: Modify a Control Block 









Modify EXLST 


9. Locate next entry in the keyword table. 














argument 7 


User-supplied A 
contro entries ! 


10. All entries handled? 


¥ Yes =p Return 


11. Is the entry valid (IKQTMSD only)? 


Yes No sone 4 Return Modified 


\ S EXLST 
/ 12. Modify the EXLST field according to the 
specifications in the paca | entry. 
Keyword table! / 
. 


Parameter list 









EXLST 
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Diagram AG1. TESTCB: Test a Control Block 






User-supplied 


'-y 1. Isacontrol block specified? 


Yes No s,>(7) 


\ 2. ¥.. control block at the given address 
match the type specified? 
‘ \ 3 ena R15 RO 
\ ‘ 4 No COO Return [4] [4] 
\ 
\ Y=» 3. Locate the keyword table entry. 


\ 
Reyna Sable +B 4. Is the entry valid (IKOTMSD only)? 








as Yes No Return R15 RO 
er | — ea 


~ 
| ae Ae 
@)-4 5. If this is “normal” keyword, compare the 
Condition 
Code 


argument field with the control block field. 








4 
/ 
~Af 
= ~2 6. {f this is a ‘‘bitstring’’ keyword, test the 
/ | 4 control block field bit by bit, according to 
7 information in the subtable and the keyword. 


/ 
ACB, RPL / =a 
or EXLST Vf Return 


/ 
He 





7. Locate the keyword table entry. 
4 





o 
a 


O} 


Notes for Diagram AG1 


The processing shown here can take place in module IKQTMSF or 
IKOTMSD (see notes for Diagram AD). 


The subroutines used for TESTCB, which have identical names in both 


modules, are: 

Block Label 

ACB TESTACB 
RPL TESTRPL 
EXLST TESTEXL 
None TESTNOB 
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Diagram AG2. TESTCB: Test a Control Block 








User-supplied | | C3 | 
argument i ? 
Parameter list control entries q 8. Is the entry valid (IKQTMSD only)? 
oa 
[Hester] Yes No CECE Return 
ba 








/ | | 
> PSW 
7 “Se 9. Compare the user-specified length with the 
4 standard contro! block length. Condition 

/ / code 
a, 
Fi / 

/ i, Return 
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Diagram AH1. BLDVRP: Build VSAM Shared Resource Pool 














zi Module 
User-issued or label 
BLDVRP macros 
VRPPL R15 
———-» 1. Is the BLDVRP parameter list valid? IKQBRP 
Yes No > Return 
2. Issue CDLOAD for the header (VSRT) of the BRP100 
VSAM Shared Resource Pool (phase IKOVRT). a 
3. Get control of the VSRT. | —isdC BRP150 
vant Basa 
——— sm 4. Does a VSAM Resource Pool already exist? BRP160 
¥ Yes mmen> (12) 
5. Calulate the length of the resource section of LENCOOO 


the resource pool. 
Storage 


6. Obtain the necessary storage by means of 
GETVIS. 


. Was GETVIS successful? 


Yes No om) 





Notes for Diagram AH1 


2. The phase |KQVRT is an assembled CSECT that contains only the 
VSRT. 
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Diagram AH2. BLDVRP: Build VSAM Shared Resource Pool 












Module 


Build resource section of VRP or label 


8. Store addresses and lengths of resource pool 
sections into VSRT. =< 


VSRT 


Resource Section 














9. Build PLH pool. 


10. Build buffer pool. 












. Build CRA pool. 


. Release control of VSRT. BRP400 


VSRT 
VSRTGATE 







Return 
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Diagram AI1. DLVRP: Delete VSAM Shared Resource Pool 







User-issued 
DLVRP macro 






. Load the header (VSRT) of the VSAM shared 
resource pool (CDLOAD for phase IKQVRT). 










VSRTGATE 


Get control of the VSRT. 



















VSRT _P? 3. Is the resource pool still in use, or is it 


- a j ? 
VSRTUNCT \ -- | non-existent? 







VSRTRLEN No Yes eummanp>(> ) 


VSRTTHBA 
_> 4. Free the storage occupied by the resource 


, section by means of FREEVIS. 
| 5. Release control of the VSRT. 


VSRTCPAH 
Return 














Notes for Diagram Al1 


1. 
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For an existing VSRT, CDLOAD simply provides addressability to the 


VSRT. 


Module 
or label 


tKQDRP 


DRP150 


DRP300 


DRP400 
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Diagram BA1. OPEN: Connect a User’s Program to a VSAM Data Set 


RO 










ACB 


2.18 


Seatieen! 










User issued OPEN 
(SVC2 issued) 


oe 


point to an ACB? 
Yes No 


(SVC2 issued) 
















(SVC11 issued) 


resource pooling? 


VSE/VSAM VSAM Logic, Volume | 


VSE open monitor 


Does .the address in the list of ACBs and DTFs 





2. Obtain and initialize a OPEN Work area 
and a dynamic storage area. 

3. Issue a CDLOAD for IKQVRM, IKOQVOPEN, 

IKQVLAB, IKOVCLOS, IKQVCAT, IKOQVMSG, 

IKQVCLC, IKOQVSTM, IKQVLASM, and 

IKOVSHR (phase names). 


VSAM open processin 
\_ a eee oe 4, is the ACB correctly identified and not open? 


Yes No 


= am a nts wens ex 
=, 
“= ——3m5. User buffer processing requested together with 
keyed processing, addressed processing, or 


‘No Yes 















Module 
or label 
NonVSAM open: peaches 
See VSE/Advanced $$BOPEN1 
feceaae Functions Diagnosis 
Reference: Vol. 1: 
General Information 
and Imperative Macros. 
Work area 
$$BOVSAM 
IKQOPN 
CHECKACB 


o> (60) 
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Diagram BA2. OPEN: Connect a User’s Program to a VSAM Data Set 


ACBUCRA ---—>, 





ACB 
ACBSCRA 


ACBAMO 













10. 
\ 
‘XN 
“N 
‘XN 

“i. 
Partition COMREG 

ities ia: 


COMLBLCY XN 
Ya : 
Label Area N 


\ 


14, 


ACB 
_ rie 
| Yes No = >(17) 
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Services? 


Module 
or label 
CALLKLAB 


Is this an open of a CRA by Access Method 


Yes No 


Is a logical unit passsed in ACB? 
Yes No 


Build a dummy label information area 
record for the CRA and insert the logicat (a) 
unit from the ACB. 
OPNWA 
ts this an open of a CRA by catalog manage- 






ment? 


Yes No ERED(17) 
aan dummy label record for the ia) 


and Insert the logical unit from the ACB. 


Is there label information to be read? 
No Yes 


Build a dummy label record and insert 
44-character name from the ACB. 


Read the label information area record. — 


Does label information indicate EXTENT Jd 







LABICREC 


EXTSYMUN 


CALLLAB 










statements are present? 


¥ Yes ee (i:) 


Is this a catalog open? 
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Diagram BA3. OPEN: Connect a User’s Program to a VSAM Data Set 





Module 


. Move logical unit specification from CAXWA jclabel 


to label area record. 







. Put unspecified indication for logical unit 
in label area record. 








. ts this a catalog OPEN? 
Yess NO > 21 


. Is aunit specified for the catalog? 


Yes > 2 1 
. Insert SYSCAT as the symbolic unit. =?) 


. Resolve file disposition from specifica- 
tions in ACB and JCL. Check validity of 
file disposition, 





. 1s the file name a default model name? 
No Yes CII 80 


. Is this a catalog open or CRA OPEN for 
recovery? 


. * NA 36 
Is the 


rea CAXWA? 


ACB SVASSOC 








FACBUAPTR _—if 
aa 






IKQOPNCT | 


No Vs > 26 CAXWA 
25. Build and Initialize CAXWA. 


COMREG 26. Build channel program to read labels. | 


COMFPROT — — 227. If DASD file protect is specified, set es 
Seas extent block to allow access to entire 
catalog volume. IKOJIBSM 


Work area 
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Diagram BA4. OPEN: Connect a User’s Program to a VSAM Data Set 


Catalog volume 


29. Read format 4-label. 


. Is this a CRA open? 





Yes No 






ACB 
ACBSCRA 
ACBUCRA 






parameter list. 


36. Is a user catalog specified in the DLBL 


statement? 


Yes No 


Label area 


a 37. Read the label area record for the UCAT, 
and insert the UCAT true-name into the 
A 


CPL. 


38. Return code 0? 
Yes No 


CB 


ACBCAT 


racescea — — ——3—39. Is this an open for CRA or catalog? 


ACBUCRA Yes No 





Notes for Diagram BA4 


28. If the user catalog is not mounted before the first job is run that 
opens that catalog, the job is terminated. 


35. The contents of the following combination names are fetched from 
the catalog: 
NAMEDS 
DSTYPNAM 
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28. Read VOL1 label and find VTOC address. 


33. Read Fi label to get address of catalog. 


. Build a catalog parameter list and field 


Module 
or label 
$1JJHCVH 


Work area 


IKQOPNCT 


m3?) 


31. Extract CRA location from F4 label. 


32. Extract the limits of the VTOC from F4 label. 


$IJJHCVH 


. Read cluster record of catalog or CRA. 


IKQOPN 








one Open work area 


IKQOPNUC 
IKQLAB 


no) 


emmm> (:') 


Section 2. Method of Operation 2.21 


Diagram BA5. OPEN: Connect a User’s Program to a VSAM Data Set 



























Module 
or labe! 
Catalog : 
40. Simulate a locate of the catalog entry 
for the 44-character name. p> (42) 
41. Get catalog entry for the 44-character name. Open work area IKQOPNHC 
See Diagram DE1, LOCATE: Retrieve Catalog 
Information. 
vA 42. \s it a path catalog entry? 1KQOPN 
y, Yes No em (45) 
AIXENTR 
OPNWA / S 
/ AIXDNAM 
STYPNAM \ : i 
arene: 2 / 43. Save information about all objects <= IKQOPNAI 
: aaaiie ais 
re Tecinam | 
BCINAM 
ead ae 44, Return code 0? : IKQOPN 
\ o> (60) 
\ Yes No 
N 
N 45, Is this an AIX which is being opened for 
independent processing? 
Yes No ome (7) 
DSTYPNAM 
46. Change the entry type to cluster. ere | 
—— —> 47. Path entry cluster being handled? 


-— + No Yes meme (“°) 





Notes for Diagram BAS 


41. The contents of the following fields and combination names are 
fetched from the catalog: 
NAMEDS 
DSTYPNAM 
RGATTR 
CATACB 


47, Path entry cluster is an AIX that is part of a VSAM path. 
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Diagram BA6. OPEN: Connect a User’s Program to a VSAM Data Set 













Module 
OPNWA NAMEDS 48. Save catalog Internal names of data and index Open Work Area or label 
ea 49. Get the data component information. IKQOPNHG 
See Diagram DE, LOCATE: Retrieve Catalog a 
Information. 
50. Is this a dynamic data set and unallocated? 
% No >> (52 ) 
51. Do primary allocation. IKQOPNOS 
See Diagram DH: UPDATE EXTEND. 
52. Save file attribute indicators for later (KQOPNNC 
ies 
on — Sw 53. Is this a reusable data set which is to be reset? 
OPNWA Peas Yes No TTP (56) 
RESETSW Peo eer er ee Be 54. First time at this step? 
¥ co > 
55. Reset the data set. IKQOPNHD 


; Lockfi! 
See Diagram DM, Release Extents. sigs tlis 


56. Invoke Lock Manager to set locks to <= {KQOCSHR 
enforce shareoptions for the com- | 
Bos ponents of this cluster. 
Lock Table 
ACBOUT — —--@ 57. Is data set to be opened for update? [fess oo 1KQOPNHG 


Ys No > Catalog 


58. Set the open for output flag. amour aver 
See Diagram DGI, UPDATE: Modify Catalog 


Information 







Notes for Diagram BA6 


49. The contents of the following fields and combination names are 
fetched from the catalog: 
AMDSBCAT 
FNTVOL 
DSATTR 
OPENIND 
BUFSIZE 
HURBADS 
USERINFO 
NAMEDS 
EXCPEXIT 
DSETEXDT 
CATACB 
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Diagram BA7. OPEN: Connect a User’s Program to a VSAM Data Set 


Open Work Area 


FLNAMDSA 





Open Work Area 


AIXPE 
AIXUPGR 
AIXYENTR 







67. 


68. 


69. 


70. 





. Save the names of components in upgrade set. 


. Set the recoverable flag in the CAXWA. 


66. 


Module 
or label 
. ls there an upgrade set associated with the iIKQOPN 
cluster? 
Yes No om (') Open Work Area 


AIXYENTR 


. Is this an open for a recoverable catalog? 


ACB 
ACBUAPTR 


Yes No CAXWA 


CAXF2REC 


em (63) 















. |s this a potential base cluster? 


Yes No emma (62) 
. Is there an upgrade set associated with the 
cluster? 
Yes No a> (62) Open Work Area 
pen seal IKQOPNUS 
. Retrieve names of upgrade set members from USB 
ae 


the catalog. ; | 


Allocate USB and copy names of upgrade set 
members, 


Return code 0? 
Yes No 


, IKQOPN 


Obtain storage, suballocate control blocks, and — 
initialize them. 


See Diagram BB, Allocate Control Blocks and 
Buffers. 


Return code 0? 
Yes No 


ACB 


Go (20) 


ACBOPEN 


Set open flag. 


. 





Notes for Diagram BA7 


63. Base cluster is a cluster that is not PE or UPGR. 


64. The contents of combination name NAMEDS are fetched from the 


catalog. 
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Diagram BA8. OPEN: Connect a User’s Program to a VSAM Data Set 





71 
4 


ACB 7 


7 







ACBCRA 


ACBCAT 
ACBUCRA 
ACBOPEN 
OPNWA ~ 


AIXFLG 
USACBAD 


OPNWA 74, 





















Space ~ a ™ 


AIXBASE 

A 

ACB 
ACBSCRA 
eed 


T""—=3. 76, 


~ 


S 77. 


78, 





Notes for Diagram BA8& 


72. This releases resources obtained by the catalog. 


t" Pd 


v 


vs ° p> (72) 


Build an entry in the OAL. 


Is this an open for catalog or CRA? 


> (73) 


Yes No 


Indicate to catalog that open is complete. 


See Diagram DE, LOCATE: Dummy locate of 
data set in catalog. 


. Is an AlX structure being handled and current 


open completed correctly? 


Yes No 


Switch to next cluster. 
See Diagram BC, Switch to Next Cluster. 


!s the base cluster of a path or an upgrade set 
member still to be opened? 


ee (4°) 


Is this an open for catalog or CRA? 


> (70) 


No Yes 


No Yes 


Ils ACBOPEN set? 


74. This can be a base cluster of a path or upgrade set member(s) for a 


base cluster. 
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Module 
or label 


OPNRAPUP 


NEXT CLU 


IKQOPNNC 


OAL 
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Diagram BA9. OPEN: Connect a User’s Program to a VSAM Data Set 





i 79, 
Ro List a 


_——S 80. 
ee 


— 
. —_— 
— 
—_ 


























oe ee ee ee >> 82 
UusB 
a 
puesree lh 
a nee => 84 
ee oe oe j 85 
| 86 
OPNWA | 
--—® 87 
_] 88 
\ 
“\ 
N 
ae 
A 
89 


» Release cluster in error. 


. Does an upgrade set exist? 


. Release all members of upgrade set. 


. Free upgrade set buffers, if they exist. 


. Release path entry cluster. 


. Does path entry exist? 


. Release path entry cluster. 


. Were data sets attached to the resource pool? 


Any more ACBs in list of DT Fs and ACBs? 


Yes No 
Exit to $$BCVS02 


Open Error Handling 





Release Close Work Area, if one exists. 


See Diagram BD, Release a Cluster. 


Yes No 


See Diagram BD, Release a Cluster. 


See Diagram BD, Release a Cluster. 


Yes No 


See Diagram BD, Release a Cluster. 


Yes No 


om, ') 


VSRT 


. Decrement the user count in resource table. VSRTUCNT 
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Module 
or label 


NEXTONE 


IKQOPNDO 
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Diagram BB1. Allocate Control Blocks and Buffers 





Close Module 
; k d Work area or label 
1. Obtain spaces for close work area an CBGETVIS 


construct close work area. | 


2. Suballocate and initialize AMBL. ‘ 


ACB 


Request-specific control blocks 
Caccise | Request-ape | 
OPNWA > 3. Is the LSR specified, or is an upgrade set - 
=< being handled? 


No Yes om: ) 
4 


. Allocate and initialize PLHs. 



















. Itisa SHAREOPTIONS (4) 
file? 


Yes no om’ ) 
4 


f 


6. Allocate and initialize file sharing work area. 






Is LSR specified? 
Ne Ys a>(:) 


Allocate RSCB. 






OWA 
LABICPTR 


Label 
information 







Suballocate volume list. Construct volume 
See list from extent information if symbolic 
units were specified in JCL. If symbolic units 
were not specified in JCL, the volume list is 
constructed from catalog volume information. 


Notes for Diagram BB1 


4. PLHs for data sets with LSR already exist in the resource pool. 
Members of an upgrade set share one PLH which was allocated 
by |KQOPNNC. The RSCB is not allocated for LSR because it 
is a member of the resource pool. 
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Volume 
cores | 
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Diagram BB2. Allocate Control Blocks and Buffers 















“ Allocation Unit for the cluster: Module 
VSAM Catalog Data Component processing G or label 
10. Suballocate control blocks specific to the (8 ) IKQOPNAB 
data component of the cluster (data 
AMDSB, EDB, LPMB, BHD). (<) 
AMBL Data AMDSB IKQOPNAB 
Miike an eee > 11. Initialize data AMDSB. =—— 3G) 
LABICREC | | | | 
ENTVO Roch aes = 12. Suballocate and initialize data ARDBs and IKQOPNOV 
VOLDDD group Ames To any additional EDBs and LPMBs required 
RBA EXTENTS -—_= for the data component. 
EXTENTS 
13. Test if proper volumes are mounted; if not, |KQASNMT 
request mount of correct volumes. 
time stamp oe 
pee 14. Request automatic assignment of logical 
ae units, if requested, and update ARDB, 
reed EDBs and volume list with logical unit 
TS ae number. 
oe peeeee _> 15. Check volume time stamp. IKQOPNOV 
imoe | BE | 
——- >» 16. If file protection is specified, build = wetoe 
data component volume | extent blocks IKQJIBSM 
ACB Zz 17. Is an index to be opened? 
” 


oe Seo et 
ACBKEYOR |-~ 
aaa 
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Data BHDs 


Data BCBs 


Yes No 


me (20) 





EXTENT BLOCKS 


ah 


oor wwe ne ee ee 
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Diagram BB3. Allocate Control Blocks and Buffers 





Index component processing 









. Suballocate control blocks specific to the 












VSAM catalog index component of the cluster (index Module 
AMDSB, EDB, LPMB, BHD). or label 
19. Get index information from catalog. IKQOPN 
See Diagram DE1, LOCATE: Retrieve Catalog 
Information. IKQOPNHC 
20. If symbolic units were not specified in 
JCL, add to the volume list any volumes => 
2 list 
used by the index component. 
AMDSB group ee (at 21. Initialize index AMDSB. IKQOPNAB 
SOLDBo aD _ = — — & 22. Suballocate and initialize index ARDBs IKQOPNOV 
ABA EXTENTS 2 and any additional EDBs and LPMBs required 
EXTENTS for the index component. 
23. Test if proper volumes are mounted; if not IKOASNMT 
timestamp tk request mount of correct volumes. 
tg el g ae io 
24, Request automatic assignment of logical IKQOPNOV 


units, if requested, and update ARDB, 
EDBs and volume list with logical unit 
number, 


ae Laer fl | 25. Check volume timestamp. IKQJIBSM 
V¥OC mee ---—— If file protection is specified build JIBs =, 
rr | | {extent blocks). ‘XN 





ACB 9 26. \s LSR specified or is an upgrade set being ‘“ IKQOPN 
a ‘\ 
Index component volume 7 4 handled? K. 
- EXTENT BLOCKS 
peti 4 No Yeo SE N>(32) X 
OPNWA ? 
7 


eC 
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Diagram BB4. Allocate Control Blocks and Buffers 


Module 
or label 


Allocation Unit for the Cluster 


Buffer, CPA and THB processing 





—— 
27. Determine the number of buffers and (4) 
suballocate BCBs (for data or data 
and index). | (e) 
28. Allocate channel! program area. 


29. Allocate buffers and connect them to the 
BCBs. 


ee oss 
—-——-——— > 30. Share option 4 specified? 


Index 
i No En >(32) AMDSB_ AMDSB 
31, Suballocate and build two Track Hold ==) 


Blocks per PLH. 


AMDSB 












ACB 
aes 
ACBKEY OK fm ae me me me we = 32. Does cluster contain data and index component? 
aaa 
es No (34) 

Data AMDSB Ind , — 
see » 33. Compare timestamps to see if index was 
TAMDSTMIST rAMDSTIST | changed since the data was last changed. 










eel ee ES) 
34. Is LSR specified? IKQOPN 
Yes No 
Resource Sharing yen IKQOPNAP 


35. Load the Resource Table. 





Notes for Diagram BB4 


30. If the data set was defined SHAREOPTIONS (4) but the 
supervisor was not generated with track hold support, then the 
AMDSSB is altered in storage to reflect SHAREOPTIONS (2). The 
AMDSB group occurrence in the catalog is not modified. 
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Diagram BBS. Allocate Control Blocks and Buffers 


-—-- >! 37. Attach PLH-pool to the cluster. = A ) 
| 
ice 38. Attach buffer subpool to the cluster (data >) 
| or data and index). 


SS | 
Nos 


N 
\, 7 39. Attach channel program area. =>) 
\ | | 


SS 40. Increase the use count. 







Resource Pool 







Return. 
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Allocation Unit for the cluster 


Data AMDSB 
Saal 
| AMOCCWA | 


r) WA 
AMOFSBCB j 


AMBL 
Da ta 
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Diagram BC1. Switch to Next Cluster 








1 
ea 
Pe 
a” 
a” 
- a” 
OPNWA yt a 
AIXFLG 
AIXPE 
AIXBASE 3. 
4. 
6. 
6. 
7. 


USB 


BC-ACB | 


ACBLSR 
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Module 
or label 


HKQOPNNC 
Is the current cluster a path entry? 


>) 


Switch to base cluster and suballocate 


ACB and RPLs in a new 
allocation chain. 
SEE Return 
Is the current ACB a base cluster? 
Yes No NNE(6 ) 
Is there an associated upgrade set? 


SEE Return 


OPNWA 


Yes No 














AIXFLG 


AIXBASE 
AIXMUS 











BCACBAD 


Reset base cluster processing. 


Yes No 


Is this the first member of the upgrade set? 


—=—s USB 
RPL 


BC-Allocation chain 


Switch to upgrade set processing. AMBL 


Move UCB into base cluster allocation 
unit and suballocate a common upgrade 


set RPL. Pp RPL 
Resource sharing? eet 
No Yes 


qmmmm>(') 


AC = allocation chain 
AU = allocation unit 
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Diagram BC2. Switch to Next Cluster 





OPNWA 


UPACBAD rae aca ae 






Names of 
US-members 
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Modute 
. Suballocate common US control blocks BC-AC or label 
in base cluster allocation unit. au Saco 
PAU TT BCACB] aopane 












11. Resource sharing? 
po Ye > (5) 
& 
12. Attach common upgrade set control { 2BHDs SBCBs 





CPA 









blocks to the control blocks for this 
upgrade set member. 


13. Attach this upgrade set member to the 


| 
USB. 


14. Search for next (first) member of upgrade set. 


15. Have all members of the upgrade set been 


handled? 
No 


v 


Yes 






AIXFLG 







16. Switch to next member, and suballocate AI XBASE 
ACB ina new allocation chain. 


Return 





17. Resource sharing? 


No Yes 

















18. Allocate minimum number of common 
upgrade set buffers, and attach them to 


the common upgrade set control blocks. 







19. 





Reset upgrade set handling flag. 


ep 











1 index 
buffer 


Return 





OPNWA 


AIXUPGR 


AC = allocation chain 
AU = allocation unit 
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Diagram BD1. Release a Cluster 


Lock File Module 
or label 





Unlock file locks for this cluster (data and . 


e IKQOCSHR 
index) and determine the number of re- We TABLE 















OPNWA 
= maining output users. =z 
OUTCOUNT ee ee ee ee ee eS. ss: the NUMber Of OUTPUT USErs NOW Zero? IKQOPNDO 
OPNWA 
Pecos Yes No mm: ) OUTCOUNT 
FILEPROT 
Catalog 
Turn off “open for output” indicator in (GGOCLC9 
catalog. 
See Diagram DG1, Modify Catalog. 
AMDSB 
——~— > 4. Free extent blocks if they exist. IKQJIBSM 


Free Allocated Storage 







« 


ACB 

























ACBLSR -»——— Does this cluster share resources? IKQOPNDO 
| rt Yes 
eat es Free buffer pool (if one exists). 
7. Free channel program area (if one exists). 
AMBAMBUF 8. Free EXPAD work area (if one exists). 
AMBLPLHF 
Reset the ACB of this cluster. = OFF 
Allocation Allocation =Q 
unit unit =0 
nes Free the allocation chain of this cluster. =0 
ney 
VSAM VSAM con- 
control blocks trol blocks 
VSRT 
11. For LSR, reduce resource pool usage VSRTUCNT IKQOPNDO 


count. 


Return 
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Diagram CA1. ISAM Interface Contents 






{SAM user - 
issued macro 


data records 


WS ie oy | 

Open a data set Create/extend Retrieve Close a | 
a data set data: records data set 

f | 

| Add Le records Direct (Random) Sequential 

| 





















Process 
errors 
OPEN macro 
CLOSE macro 
Request macros 


See Diagrams 
CN - CP 


Process 
CLOSE macro 


See Diagram 
CM 











Process 
SETL macro 
GET macro 
PUT macro 
ESETL macro 


See Diagrams 
Cl-CL 





Process 
READ macro 
WRITE macro 
WAITF macro 


Process 
WRITE macro 
WAITF macro 


See Diagram 
CF 


Process 

SETFL macro 
WRITE macro 
ENDFL macro 


Process 
OPEN 
macro 


See Diagram 
CB 












See Diagrams 
CG -CH 


See Diagrams 
CC -CE 
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Diagram CB1. OPEN: Connect a User’s ISAM Program to a VSAM 
Data Set 





















User-issued oe 

OPEN 
RO (SVC 2 issued) 

List VSE OPEN monitor NonISAM open: 
Le ee 1. Does the address in the list of DTFs and ACBs See VSE/Advanced Functions $$BOPEN 
point to an ISAM DTF table? Diagnosis Reference: LIOCS Peaaag 
Yes No = Vol. 1 General Information BO 
Le - and Imperative Macros. 
System Label Area | 
, F User label save area 
svez_ |_| 2. Read DLBL/EXTENT information from system 
User label save area label area into user’s label save area. 
<-> > 3. Isa VSAM data set connected with the ISAM SANT ADER: $$BOPEN2 
Core Image Library DTF? See VSE/Advanced Functions 





No oo Diagnosis Reference: LIOCS 
| vol 3: DAM and ISAM. 


v a CDLOAD for IIPOPEN. aieOean 


‘h 


Save the user’s return address and replace it by | User save area 


JOBNAME)Old ; BSW TIPORER 1 the address of IITPOPEN. Old PSW 
User return addréss 


Core Image Library (SVC 11 issued) 


YW uPOPEN processing processing 
Issue a CDLOAD for the ——Yroren peeing —___ interface + 1iPPRCPR 
processor. 


-_> 7, Is this the first OPEN for that file? IIPOPNOO 


DTFIS 
Anineere | Yes No me (1) DTFIS 


eee 


User save area 5 





| 























SS ee ee > 8. Initialize some fields in part 1 of the DTF table 
used by the ISAM interface processor. 






Notes for Diagram CB1 


1, The VSE OPEN Monitor examines the DTF -type field (offset 20 
of the address passed in the list) of the DTFs or ACBs. If the byte 
indicates an ISAM file (X'24’, X'25', X'26', or X’27'), an SVC 2 is 
issued and $$BOPEN2 is fetched into the B-transient area, (If the file 
is not an (SAM file, the regular OPEN continues). 


The list pointed to by register O may consist of pointers to DTF tables 
and/or ACBs. Register 0 is provided by the user program. 


3. LABEL TYPE’A’ means that an ISAM file is connected with a VSAM 
data set. 


4. IIPOPEN is loaded into the caller’s partition, and its address is 
returned in R1. 


6. !IPPRCPR is loaded into the caller’s partition, and its address is 
returned in R1. 


7, Bit X’80' in FLAGBYTE is set by I{POPEN after the first successful 
OPEN for the VSAM data set. 


8. The information needed to initialize the fields in part 1 of the DTF 
table is derived from part 2 of that table. The only purpose of this 
transformation is to provide better access to these items for the 
{SAM Interface Processor. 
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Diagram CB2. OPEN: Connect a User’s ISAM Program to a VSAM 


Data Set 





Core image Library 





Get storage for the AMDTF table. 


- OTFIS 
10. Load the AMDTF table and store its address. ane! 
AMDTFAD 
eas 


R1 
AMDTF 





| Rt 












7 11. Issue a GENCB to generate the ACB. 
R1 yt ACB 
auere 
R aaa 
aa nn > 12 Store the address of the ACB. 
ee ee a 13. Open the ACB. 
DTFIS | 
ECRGEYTE ~~ be 14. Is this the first OPEN for that file? 
Pee a] 
Yes No > ('°) 
DTFIS 
15. Get key and record lengths using the SHOWCB 
function. 
eae 
16.  tssue a GENCB function to generate the RPL. R4 8 
| AMOTF 
R1 
cr oe 17. Store the address of the RPL. oo 
| DTFIS 
18. Update addresses in DTF table. —— > { 
AMDSB 
pee 19. Store filename. T information into DTF table. ae 
ee | 
ee ease ee ae | Sp» 20. Increment file list pointer (RO). 


Return. 





Notes for Diagram CB2 


10. The AMDTF table contains the parameter lists for the GENCB ACB, 
GENCB RPL, SHOWCB, and MODCB RPL macros, and the ERREXT 
parameter list used by the ISAM program in case of errors. The AMDTF 
table is loaded via the LOAD macro. 


11. The parameter list in the AMDTF table for the GENCB macro is 
completed as follows: 


® Copy the filename from the DTF table 
@ Specify the MACRF element according to the |OROUT parameter 


in DTFIS: 

{OROUT KEY DIR SEQ IN OUT 
LOAD X x x 
ADD x x x 
ADDRTR- X x x 54 x 
RETRVE xX xX x x x 


13. The address of the ACB (pointed to by RQ) is followed by a non-zero 
byte to make sure that control returns to !1POPEN after opening the 
ACB. 


15. Since key length and record length are not generated in the DTFIS 


macro expansion for retrieve files, this information is extracted from 
the ACB via a SHOWCEB. The field LRECLEN eventually contains the 
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16, 


18, 


21, 





VSAM record length for biocked records and the VSAM record 
length diminished by the key length for unblocked records. 


The parameter list for the GENCB macro in the AMDTF table is 
completed by storing the key length, record length, and ACB 
address in it. 


The logic module address in the DTF table (LOGMODAD) is 
replaced by the address of the LOAD branch vector in IIPPRCPR 
or the address of the general branch vector, depending on whether 
the ISAM file is a LOAD file. The beginning address of |IPPRCPR 
is also stored (CIPROCAD). The LOGMODAD field is used to pass 
control from the user to data management. The address of the ISAM 
module is replaced by the branch vector address in IIPPRCPR, and 
control automatically goes to the ISAM Interface Processor instead 
of the ISAM logic module. CIPROCAD is referenced when the user 
issues a SETFL, ENDFL, or SETL macro to pass control from the 
$$B-phases to the ISAM interface processor (CIPROCAD is a 
pointer to the address list at the very beginning of 1IPPRCPR). 


If there is no further element in the list, control is returned to the 
instruction in the user program that follows the SVC 2. Otherwise, 
control is returned to the SVC 2 instruction. 
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Diagram CCl. Load Data Records: SETFL 

















User-issued 
SETFL 
(SVC 2 issued) 


RO 










CIPROCAD 





1. 


file? 


Yes 
Address table 





User save area 


JOBNAME Old 









SVC 11 









IOAREAL 
KLM1 
PPRETAD 


“| data set. 


Notes for Diagram CC1 


1, Bit O in the flag byte (offset 16 in the DTF table) is set by ITPOPEN 
after a successful OPEN of the data set. 


3. Fields in the OTF are set as follows: 
@ FNAMEC to X‘00' 
® CISWITCH to ‘LOAD’ and ‘FIRST WRITE’ 


® KLM1 is initialized with ‘key length — 1’. The key length is 


derived from the field KEY LEN which was initialized by IIPOPEN. 


4, The key information in this form in (OAREAL is used after SETFL 
by various problem programs, for example, PL/I. 
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ISAM SETFL processor 


is a VSAM data set associated with the ISAM 


Neola eR ERR ERR SR RER HERES 


replace it by the address of the SETFL 


ro routine in the !SAM interface processor. | 


ISAM interface processor 


3. Initialize fields in the DTF table. on 


> 4. Issue a SHOWCEB to see if the data set 
Sg cals aa ~| is empty; if empty, set key field to 
ge X’F’s or, if not empty, set to X’0's. 


| 5. Store CREATE/EXTEND status of 


Module 
or label 


ISAM. SETFL processor: 





$$BSETFL 








See VSE/Advanced 
Functions Diagnosis 
Reference: LIOCS 
Vol. 3: DAM and 
ISAM 






| aes __ 


— 







FNAMEC 


CISWITCH 
-KLM1 | LM1 


IIPPRCPR 
SETFL 


= IOAREAL 


DTEIS 


MIXEXTt 
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Diagram CD1. Load Data Records: WRITE 




















Module 
or label 

User-issued 

WRITE 

R1 
ISAM interface processor 
IIPPRCPR 
CISWITCH me ee ee > 1. ss this the first WRITE after SETFL? WRITENKL 





My No mm>(:) 


MIXEXT) pe ae ee 3S» 2. Is data set to be created or extended? 


VSAM data set Create Extend 







3. Is key supplied greater than the 








-_— highest key already on the data 
Lae Bee DTFIS 
pag as areas 
T key i gone oe oe, 
a —— 
+ Data in > 4 . | RPL 
WwoRKL [{;f/ ~ = ?7"-7—"" * Modify RPL. 
Blocking 
information | 
Ro 5. Issue a VSAM PUT. 
MOAREAL pies 
eee eo —* 6. Store key in IOAREAL. 
Return 
Notes for Diagram CD1 4. AMODCB is issued with the following OPTCD code: KEY, SEQ, 
SYN, NUP, MVE, 
1. Control is passed from the user to the ISAM interface processor via 
the LOGMODAD field in the DTF table, which, after OPEN, contains The AREA element in the MODCB parameter list is initialized. It 
the address of the LOAD branch vector in the ISAM interface specifies the address of WORKL. Since the address of WORKL is 
processor. not supplied in the DTF macro expansion for LOAD files, it is 
derived from the address of the key in WORKL if RECFORM=F1IXUNB 
1-2. The two switches referenced in these steps are set by the ISAM and the address of the data in WORKL if RECFORM=FIXBLK. 


interface processor routine SETFL. 
6. The key is stored in 1|OAREAL mainly for the benefit of problem 
3. To perform the sequence check, a dummy GET is issued that is programs (for example, PL/I) which may check this field. 
prepared by a MODCB with the OPTCD code: KEY, DIR, SYN, NUP, 
KGE, FKS, LOC. 


If the return code following the GET operation is zero, this indicates 
that a sequence error has occurred, that is, that a record with a key 
equal to or greater than that in WORKL is already on the data set. 


If the return code following the GET operation is not zero, control 
is passed to the general error routine ERGN in JIPPRCPR. This 
routine analyzes the error. If the error is ‘no record found” and the 
first write’’ bit in CISWITCH is on, the error is ignored and normal 
processing continues. 


Note: The sequence check for subsequent PUTs is done by VSAM. 
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Diagram CE1. Load Data Records: ENDFL 









Module 
or label 





User-issued 
ENDFL 
(SVC 2 issued) 


ISAM ENDFL processor 





ISAM ENDEL processor 


See VSE/Advanced $$BENDFL 
Functions Diagnosis 


Reference: LIOCS 
Yes . No CEO) Voi 3: DAM and 






FLAGBYTE 
CIPROCAD 


—-=— eee > . Isa VSAM data set associated with the ISAM 
file? 


















ISAM. 
2. Save the user’s return address and replace it by | eae 
the address of the ENDFL routine in the a 
ISAM interface processor. PPRETAD 
User save area oe 
JOBNAME ol SW SVC 11 


User return address 


AMDTFE 







ISAM interface processor 











—— = 3. Issue a TCLOSE for the VSAM data set. 1IPPRCPR 
eens ENDFL 






c> 4. Return. 
DTFIS 


AMDTFAD 
PPRETAD —---—--—-—--4 


Notes for Diagram CE1 


1. Bit O in the flag byte (offset 16 in the DTF table) is set by IITPOPEN 
after a successful OPEN of the VSAM data set. 
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Diagram CF1. Add Data Records 










User-issued 
WRITE 





ISAM interface processor 











CISWITCH 
AMDTFAD 


— ee > S.sSWass the last request for this data set an ADD? 





Yes No 





2. Modify the RPL. 


—— = 3. Issue a VSAM PUT. 


Return 











User-issued 
WAITF 


ISAM interface processor 






4. No function is performed. Control is 
immediately returned to user. 





Return 


Notes for Diagram CF1 


1. Control is passed from the user to the SAM interface processor via 
the LOGMODAD field in the DTF table, which, after OPEN, contains 
the address of the general branch vector in the ISAM interface 
processor. 


2, AMODCEB is issued with the following OPTCD code: KEY, DIR, 
SYN, NUP, MVE. 


4. See note 1. 


Licensed Material — Property of IBM 


Module 

or label 
RPL 1IPPRCPR 

WRITENKA 
VSAM data set 

WAITF 
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Diagram CGI. Direct (Random) Processing of Data Records: READ 





















Module 
or label 
User-issued 
READ 
ISAM interface processor 
. Was the last request for this data set a READ? Hae ae 
No 
¥ RPL 
2. Modify the RPL. <I  d 
| DTFIS 
eee 
ISAM interface processor 
. Are the records unblocked? WAITF 
Ps No (6) 
Replace the address of the VSAM record 
by the address of the data in the record. 
6. WORKR specified in DTFIS? 
Yes No 
IOREG 
S>7. Load the user's IOREG 
LOIOREGR ae Return to 
LDIOREGR { sicer. | WORKR 
L. Se 8. Move data part of VSAM record. 
4 
Return 


Notes for Diagram CG1 


1, Control is passed from the user to the [SAM interface processor via 
the LOGMODAD field in the DTF table, which, after OPEN, contains 
the address of the general branch vector in the ISAM interface 
processor. 


2. The records are processed by VSAM in MOVE mode when WORKR= 
name and RECFORM=FI1XBLK are specified in the DTFIS. The 
OPTCD parameters for the RPL modifications are KEY, DIR, SYN, 
UPD, KEQ, FKS, and MVE. 


The records are processed by VSAM in LOCATE mode in all other 


cases, and the OPTCD parameters are KEY, DIR, SYN, UPD, KEQ, 
FKS, and LOC. 


The WORKRAD1 field in the DTF table (which contains a pointer 
to WORKR) used for MOVE mode is initialized by |1POPEN, as well 
as KARGAD1 (which contains a pointer to the key). 


3. If LOCATE mode is specified, VSAM returns the address of the 
VSAM record in the DTF after the GET operation. 


4, See note 1. 
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Diagram CH1. Direct (Random) Processing of Data Records: WRITE 






















































Module 
or label 
User-issued 
WRITE 
ISAM interface processor 
Is the record to be processed in MOVE or HPPRCPR 
LOCATE mode? MAUTERES 
R1 
aes Loc MVE mn (:) 
RO 
OTE Indicate to VSAM that this is an UPDATE in Px'24 
LOCATE mode. 
VSAM 1/0 buffer 
-——— oe so'3. Move the content of WORKR into the 
VSAM I/O buffer if WORK R=name and 
areas RECFORM=F!XUNB was specified in 
the DTFIS macro. VSAM data set 
fc = 4. Issue a VSAM PUT. 
i ne 4—_____—— 
Return 
User-issued 
WAITFE 
following a WRITE 
ISAM interface processor 
WAITF 


5. No function is performed. Control is 
immediately return to user. 


4 


Return 





Notes for Diagram CH1 

1. See notes 1 and 2 for Diagram CG1. 

2. Since VSAM does not allow update of records in LOCATE mode 
on the one hand and the ISAM interface processor, on the other 
hand, needs update in LOCATE mode, a special PUT is issued which, 
by means of the value passed in register 0, indicates to VSAM that the 
request comes from the ISAM interface program. 


5. See note 1 for Diagram CG1. 
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Diagram CI1. Sequential Processing of Data Records: SETL 








Module 
or label 





User-issued 
SETL 
(SVC 2 issued) 









ISAM SETL processor 


CIPROCAD 
AMOTEAD 


ISAM SETL processor 


Is a VSAM data set connected with the ISAM $$BSETL 






See VSE/Advanced Func- 
tions Diagnosis Reference: 


> 
DTF? 
LIOCS Vol 3: DAM and 
¥ No Cor issu ti—<C~ts*S 
> 













= 2. Save the user's return address and replace it by eras 
the address of the SETL routine in the ISAM os ool 
interface processor. PPRETAD 


Q 
SVC 11 


ISAM interface processor 


ae 
RPL 
OTFIS \ [°° "3. Modify the RPL and issue a POINT to the IIPPRCPR 
Sea \ designated data set location. ERRORS, 
\ ‘ 
aaa ~ ~ 4. Modify the RPL for subsequent GETs and 
“A PUTs. 


| 5. Return to user. | 


Notes for Diagram CI1 


1, Bit Oin the flag byte (offset 16 in the DTF table) is set by 
{IPOPEN after a successful OPEN of the data set. 


3-5, A MODCB is issued with the following OPTCD parameters to 


prepare for subsequent GETs and PUTs: KEY, SEQ, SYN, UPD, 
and LOC. 


Thus, all records are to be processed in LOCATE mode. 
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Diagram CJ1. Sequential Processing of Data Records: GET 




















Module 
or label 
BUBEE User-issued 
oF 
aaa (ee 7 
| 
VSAM data set | ISAM interface processor DTFIS 
| 
L_ se 1. Issue a VSAM GET. WPPRCPR 
~ [~ = 82. WORKS specified in DTFIS macro? 
R1 I Yes No 
) 1OREG 
DTFIS {e---- 3. Load the user's IOREG 
haar 4 | | register. , Return 
i eee a ea GP => 4. Move the contents of the record in the i] WORKS 
- 
an I VSAM 1/0 buffer into WORKS. | Key | Data 
| 
\_---_---_- J Return 





Notes for Diagram CJ1 


1, Control is passed from the user to the ISAM interface processor 
via the LOGMODAD field in the DTF table, which, after OPEN, 
contains the address of the general branch vector in the ISAM 
interface processor. 
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Diagram CK1. Sequential Processing of Data Records: PUT 
























Module 
or label 
al User-issued 
i PUT 
DTFIS 
~e 
Pe 8 ISAM interface processor 
Te es 
se me > 1. WORKS specified in OTFIS macro? 1IPPRCPR 
~ 
a: ~ | Yes No mmp>(;) 
en , 
2. Move the contents of WORKS into the VSA VSAM data set 
1/0 buffer and request type to RO. 
—_-—> 3. Issue a VSAM PUT. 


Return 


Notes for Diagram CK1 


1. Control is passed from the user to the ISAM interface processor via 
the LOGMODAD field in the DTF table, which, after OPEN, contains 
the address of the general branch vector in the ISAM interface 
processor. 


1-3, Since VSAM does not allow update of records in LOCATE mode on 
one hand and the ISAM interface processor, on the other hand, needs 
update in LOCATE mode, a special PUT is issued which, by means 
of the value passed in RO, indicates to VSAM that the request comes 
from the ISAM interface program. 
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Diagram CL1. Sequential Processing of Data Records: ESETL 
















Module ° 
Rl or label 
User-issued 
ESETL 
OTFIS 
AMDTFAD 
ener =m) 
. Issue an ENDREQ request. 1IPPRCPR 
ESETL 


Return 


Notes for Diagram CL1 


1. Control is passed from the user to the ISAM interface processor via 
the LOGMODAAD field in the DTF table, which, after OPEN, contains 
the address of the general branch vector in the ISAM interface 
processor. 
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Diagram CM1. CLOSE: Disconnect a User’s ISAM Program from a 
VSAM Data Set 




















































Module 
label 
User-issued alas 
CLOSE 
~ (SVC 2 issued) 
7 BC E 
VSE CLOSE monitor PEBCLOD 
ISAM close: 
; : awe 
. ls a VSAM data set associated with ISAM file? See VSE/Advanced 
Functions Diagnosis Re- 
Yes No ERESE SS ference: LIOCS Vol. 3: 
$ | DAM and ISAM 
. 2. Load IIPCLOSE using the CDLOAD ——— 5 
User save area function. 
Old PSW.z a 3. Save the user’s return address and replace it by DTFIS 
the address of IIPCLOSE. a 
IIPCLOSE processing 
4. Reset CISWITCH to X‘00’. AMDSB HIPCLSOO 


seis | ey 
ee 
Se ae eee aa aS >> 5. Incaseof RTRVE or ADDRTR files, store anes) 
the contents of filename.T into the 
AMDSB. 
~~—e 6. Issue a VSAM CLOSE. 


| RO 
> 7. Increment the list pointer and return to $SBCLOSE 


(y _-- user. | 


Return 


| 


Notes for Diagram CM1 


1, Bit O in the flag byte (offset 16 in the DTF table) is set by IIPOPEN 
after a successful OPEN of the data set. 


7, When no elements are left in the list, control is returned to the 


instruction immediately fottowing the SVC 2 in the user program. 
Otherwise, control is returned to the SVC 2. 
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Diagram CN1. ISAM Interface Error Processing: OPEN 





Module 
Error occurred during open or label 
1. Did the error occur before the ISAM interface $$BOPEN2 
processor was successfully loaded? NPOPNOO 
Yes No omm>(:) 
R15 S 7 RO 
L_Return code [> 2. Store the return code. 


RO 


| SYSLOG 
|PBMROO 
|__Return code [> 3. Print the error message. 


4. Cancel the task (SVC 6). 


aay 


Return 
5. Set various message registers for the —— 


Message Registers 








R15 HPOPNOO 
message routine. 
6. Did the error occur after the ACB was 
successfully opened? 
No Yes 
7. Issue a VSAM CLOSE for the 1IPPRCPR 
a agi data set. 
lessage Hegisters SYSLOG 
SS 8. Print error message and cancel the task —t | NPPRCMR 
(SVC6). 
RGMERC 
Return 


Notes for Diagram CN1 


1. If the ISAM interface processor is not loaded, a separate message 
routine must be used. 


2. Return code is moved to RO, in preparation for the message routine. 
3. Return code loaded into RO during step 2 determines message. 

5. Registers are set up for IIPPRCMR. 

7. Data set must be closed. 


8, Uses registers set up in step 5. 
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Diagram CO1. ISAM Interface Error Processing: CLOSE 


Error occurred during close 





R15 


[ Return code | [7 2. 


RO 


[renee 8 


R15 


[Retincode =, 


Message Registers 





Notes for Diagram CO1 


Did the error occur before the ISAM interface 
processor was successfully loaded? 


Yes No mmm 5) 
RO 
Store the return code. 
| SYSLOG 


Print the error message. 


Cancel the task (SVC > Return 


Message registers 


RGMIR 
[RGMVA | 
RGMCASE 
RGMRC 
RGMRSC 


SYSLOG 1 


Ra Return 













Set various message registers for the 
message routine. 


Print the error message and cancel the 
task (SVC 6). 


1. If the ISAM interface processor is not loaded, a separate message 


routine must be used. 


2, Return code is moved to RO, in preparation for the message routine. 


3. Return code loaded into RO during step 2 determines message. 


5. Registers are set up for IIPPCRMR 


6. Uses registers set up in step 5. 
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Module 
or label 


$$BCLOSE 


IIPBMROO 


lIPCLSOO 


IIPPRCMR 


Diagram CP1. ISAM Interface Error Processing: Request Macros 


Error occurred during functions other than 
open or close Message Registers 
6 5 ee er ee 
[Return code > 21. Indicate ISAM and failing VSAM request. 
—— 







— 
— a 
~~ aw 






Se 2. Did the error occur after a MODCB or 
SHOWCE, or was the return code from 
an action macro (R15=4)? 


i No >) 


3. Issue VSAM CLOSE for the data set. 





Message Registers 





SYSLOG 


ee 4. Print the error message. —— ny 


5. Cancel the task (SVC 6). 


> Ren 


6. Issue a SHOWCB for the feedback information 
in order to analyze the error. 







7. SHOWCEB failed? 
SYSLOG 


8. Print the error message and an 


cancel the task (SVC 6). 


aa ‘Return 


9. Was it a physical or logical error? 


Logical Physical 


(0) > (2) 





Module 
or label 


tIPPRCPR 


HIPPRCMR 
HIPPRCPR 


HIPPRCMR 
IPPRCPR 
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Diagram CP2. ISAM Interface Error Processing: Request Macros 


Module 
or label 


Error occurred during functions other than open 
or close (continued) 





10. Was the error one of the following? 


— End of data set 
— Duplicate record 
— Record out of sequence 
— No DASD space available 
— No record found 











Yes No 





SYSLOG IIPPRCMR 
IIPPRCPR 





Issue a VSAM CLOSE for the 
data set. 








. Print error message and cancel 
task (SVC 6). 


=a Return 


13. Store information into filename.C. 
















FNAMEC 





14. Dida READ or WRITE error occur on a data, 


index, or sequence set? 
SYSLOG 


Yes No 


15. Issue a VSAM CLOSE for the HHPPRCMR 


data set. 
DTF IIPPRCPR 


FNAMEC 






16. Print error message and cancel 


task (SVC 6). 


=> Return 


Indicate irrecoverable 1/O error in file- 
name.C. 













17. 
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Diagram CP3. ISAM Interface Error Processing: Request Macros 









7 ‘ Module 
ahi Error occurred during functions other than open or label 
or close (continued) 
IIPPRCPR 


ae ee = 18. Did user specify ERREXT in the DTFIS? 


Yes No (E> Return 





19. Store error code in ERREXT parameter 
list. 





EREPL 
R1 
Baia 





User’s 
ERREXT 
routine 


20. After user error routine processes, control 
is returned to HIP via the ERET macro. 





21. What was ERET parameter? 


R Skip or 
etry IGNORE mamas Return 








User's 
routine 


RGRTRY 





Retry Address a re : a : ‘ 
— > 22. Give control to the failing operation via 


RGRTRY register. 
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Diagram DA1. Catalog Management Contents 


Obtain a Modify a 
catalog catalog 
record record 
field’s value field’s value 


Check the Locate: Updates Update- 

password Retrieve Modify extend: 
catalog catalog Obtain 
information information additional 


See Diagra See Diagra See Diagra See Diagram See Diagram See Diagram See Diagram See Diagram See Diagram 
DC DD DE DG DH DJ DK DL DM 
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Diagram DBI. 









request. 





Catalog 
record 
identifier 


blocks and work area. 


Overview. 





Notes for Diagram DB1 


Description Module Procedure 


VSAM catalog management (CM) is called with 
a CATLG macro instruction by VSAM Open, 
Close, and end-of-volume routines. In addi- 
tion, a user’s program can process VSAM 
catalog records by issuing an Access Method 
Services request. Access Method Services 

also issues the CATLG macro, which 

translates the request into an SVC 65 and a 
catalog parameter list (CTGPL). 


The CATLG macro instruction checks to see 

if the called VSAM CM module is in storage. 2. 
If it isn’t, the module is loaded from the 

Core Image Library. Register 1 contains 

the address of the caller’s (CTGPL. The 

CTGPL identifies which catalog record to 

process and what process to perform. 


1. The catalog control area (CCA) contains IGGOCLC9 
data about catalog records retrieved to 
process the request. The CCA also con- 3. 
tains a register save area that shows the 
flow of control between CM routines 
used to process the request. 


BLDCCA 
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“Diagrams BA, GA 





Build and initialize a CCA for the caller’s 


See Diagram EB1, Catalog Management Services 


Catalog Management Overview 


R11 
tcca 
A 


cc 
| torcee CTGPL 
: 


CTGPL 





2. Determine if the specified catalog is open and 
if not, open the catalog and build control 
See Diagram BA, OPEN: Open the catalog. 


If the caller issued an Access Method Services 
command, process it and bypass steps 4-9. 


CTGFLs 


i 





ACB AMCBS CAXWA 


Module Procedure 


Description 


Each time a CM routine is called by 
another CM routine, the contents of 
registers 12, 13, and 14 are put in the 
CCA's register save area. See the Data 
Areas section of this manual for details 
about the CCA and CTGPL, and the 
Diagnostic Aids section for informa- 
tion about the CCA register save area. 


The catalog driver is then called to IGGOCLAB !GGPACDV 
determine what request was issued and 


which routine processes the request. 


The master catalog’s AMCBS is built, if 

it has not already been built. A check is 
then made to see if the master catalog is 
open. If it is not open, IGGOCLAD calls 
$$BOPEN to open the master catalog and 
then builds the master catalog’s ACB and 
CAXWA. Control is returned to 
IGGOCLAC and then to IGGOCLAB. 


An Access Method Services command is 
translated into a catalog management 
services (CMS) request to define (create), 
alter, delete, or list catalog records. 
IGGOCLAT then returns to |GGOCLAB. 


IGGOCLAC 
IGGOCLAD 
$$BOPEN 

IGGOCLAD 


IGGPMCO 
IGGPMCO2 


IGGPMCO2 


IGGOCLAT IGGPCDVR 
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Diagram DB2. Catalog Management Overview 


LUB 
catalog entry 









CM Buffer 


Catalog record 






Verify that caller’s work area and each CTGFL 
is within the caller’s address space. 













5. Retrieve the catalog record identified by 
the caller. 


See Diagram DC1, Search: Retrieve the Base 
Catalog Record. 


6. Check the password value for catalog security 
processing, if required. 
Va See Diagram DD1, Check the Password. 


Operator-supplied 
password Authorized Not authorized @L 








Notes for Diagram DB2 Description Module Procedure 
Description Module Procedure The catalog cluster record is retrieved IGGOCLEG = IGGPGET 
for catalog security processing. The IGGOCLAZ IGGPEXT 


4. The caller’s work area and each CTGPL IGGOCLAY !GGPSCNC 


are checked to ensure that they are ; re : 

within the caller’s address space. also be retrieved, if it exists. Control 
is then returned to the catalog calling 

The field-name value in the field paraa IGGOCLAY IGGPSCNC function. 

meter list (CTGFL) is used to obtain 

dictionary data that defines the field’s 

characteristics and location within the 

record. Control is returned to 

IGGOCLAB. 


5. The catalog record is identified by the !GGOCLFH IGGPSCAT 
caller’s DSNAME value, volume serial 
number, or control interval number. If 
the CTGPL's catalog identifier addresses 
the record’s control interval number, 
the catalog record can be retrieved with- 
out a search of the catalog’s index. Con- 
trol returns to the calling function. 


6. The caller’s request type determines the IGGOCLBM IGGPCKAU 
password value that, when supplied by 
the operator or input stream, allows the 
VSAM CM routines to complete the 
caller's request. 


password group occurrence data must 
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Diagram DB3. Catalog Management Overview 


R1 


CM Buffer 





7. Determine the request type and process it: 


(a) Update ggg» See Diagram DG1, UPDATE: 
Modify Catalog Information. 


(b) Locate ggg See Diagram DE1, LOCATE: 


Retrieve Catalog Information. 


_— 7 8, Update catalog control record if not already 


updated. 


oat as 


10. Release storage obtained for this request. 


Notes for Diagram DB3 
Description , 


7(a) An Update request modifies 
information in a catalog record. An 
Update request can also obtain 
direct-access space for the data set 
or index identified by the DSNAME 
value. Control is then returned to 
the catalog calling functions. 


(b) A Locate request retrieves informa- 
tion from the catalog record. 
IGGOCLBA is called to determine 
those occurrences from which field 
data should be retrieved. Control is 
then returned to the catalog calling 
functions. 


8. When the VSAM catalog driver 
(1GGOCLAB) returns to the catalog 
first load module, |GGPRCU finds 
out if the CCR has been updated in 
storage. If so, IGGPCCCR is called 
to update the CCR and turns to 
caller. 


Module 


IGGOCLAV 
{GGOCLBB 


IGGOCLAZ 
IGGOCLBA 


IGGOCLC9 
IGGOCLEG 





R15 


Return 
Procedure Description Module Procedure 
IGGPUPD 9, {!GGPRPLF frees the RPL for other 1GGOCLAB IGGPRPLF 
IGGPUPDE requests and returns to the catalog 
first load module. 
All storage obtained for work areas IGGOCLC9 IGGPRCU 
and control blocks is freed and 
returned to the system. A 
IGGPLOC return code is set in register 15, 
IGGPTSTS control returns to the caller. 
IGGPGVAL 
(GGPGREC 
IGGPRCU 
IGGPCCCR 
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Diagram DC1. Search: Retrieve the Base Catalog Record 












Module or 
R11 *Diagrams DB, EB, EK, EL, EM procedure 
CTGCAT 
Catalog identifier 
1. ts this a DEFINE/ALTER request? IGGOCLAH 
iGGPSCAT 
Catalog record 
Saiss 





Request type 
CTGPL CTGFV 


* CTGFV 





Address 
of entry 
name 

CTGFL 


2. ay, the address of the catalog 
record identifier in register 1. mnie eee 


-- Ss 3. Save this request's eran, pointer in 
register 1. 





4. |s the catalog search to be made by true name? 










CCASRDD 


CCASRCH 


CCAF1IKGE 






6. Move 44-byte true name into CCA, and 
set search indicator. 


5. uw the control interval = 
number into 
the CCA, (>) | 







Is this a LISTCAT request? 


8. av indicator to retrieve 
next catalog record. 


. Does CTGPL catalog record identifier point to 
special catalog open intercept name? 


No Yes memma> (2) 


© 
¥. 





9 





Notes for Diagram DC1 


The CTGPL’'s catalog identifier field, set by the caller, can contain the 
address of a catalog’s ACB, the address of a catalog’s DSNAME, or 0. 


See the Data Areas section of this manual for details about the CCA, ACB, 
and CTGPL. 


The CMS DEFINE routine calls the search catalog routine to confirm that 
when a caller wants to create a VSAM cluster or catalog, the new cluster 
or catalog DSNAME is not duplicated in the catalog. The caller (CMS 
DEFINE) expects the “no record found” return code. 


4, If the catalog record identifier is not a true name, it must be a 
control interval number. In this case, the catalog identifier (CTGCAT) 


must contain the address of the catalog’s ACB. 


8. The caller did not know the address of the catalog’s ACB and 
IGGOCLFH must locate it. 
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Diagram DC2. Search: Retrieve the Base Catalog Record 
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Processing? 2 R11 
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Module 
or procedure 


Describes an 
B open VSAM 
catalog 


. LCBSCRACB | . ; CCA 
12. Translate true name into a control inter- ———— (eens) 
val number in CRA, 
= i @ 
ee Se a 13. ts ACB address supplied? IGGPSA 
eae is ves 
re 7 
Bees 
14. Set ACB address into CCA. 
“= 15. Catalog filename supplied? 
basin | No Yo S_——- 8» (17) 
©) & 
area aw 
cAXGNAM —_— — — — — ~ — — ww I16. Catalog name a master or 
job catalog? 
RI Yes NC > (27) 
(+> 17. Determine filename for reading the label 
information area. 
| 
\ J EE 18. Read label information area. — 
rereopus J (c) , seceeaiezes 
U es eee 19. LOCK exclusive on CAXWA chain. 
CTGOPTNS 
=> 20. Is this an OPEN request for DEFINE of user pee een 
ee ee catalog? 
Ne Nes > (2) 
repel Ares 21, Search the CAXWA chain for the VSAM IGGPSCAX 
= ->(c) ae -P catalog by true name. 
- 
nwo aa 22. Was the catalog’s CAXWA found? 
CAXWA 7 










No Yes 


y 


CAXCHN TY 


aaa 
CAXCNAM 
ae: 







Notes for Diagram DC2 


10- If the AMCBS indicates the presence of 1DCDF60 (an Access Method 

12. Services parameter list), catalog management must use the CRA to 
retrieve data set information. This is the type of processing used by 
the EXPORTRA and t{MPORTRA functions. 


13- If the CTGPL’s catalog identifier field CTGCAT and/or the CTGPL's 

18. pointer to the user catalog’s filename CTGDDUC contain O, then the 
job catalog is searched if it exists, and if it does not, the master 
catalog is searched. Otherwise the specified user catalog is used. The 
AMCEBS contains the address of the CAXWA chain. 


20. For DEFINE of user catalog, the CAXWA chain cannot contain the 
requested CAXWA. Therefore no scanning is necessary. 


21. The CAXWA chain contains only CAXWAs referring to the ACBs 
22. of open catalogs or CRAs. 
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Diagram DC3. Search: Retrieve the Base Catalog Record 
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Exit with error. 
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[ACBDDNM_| cs mee oe 
| ae CAXCMR 
Set ACB address into the CCA. 
i AASE | CAXCNAM_| 
Enqueue exclusive on user catalog OPEN and CCAREASN aes 
shared on user catalog. 
Issue OPEN. AMCHS PCAXCMP 
Add CAXWA to chain. 






CAXWAs 
Dequeue from user catalog OPEN and user CAXCHN | 
catalog. aces 


Dequeue from CAXWA chain. 


Is catalog recoverable? IGGPSCAT 
Yes No n> :) 
ls it DELETE, DEFINE, or ALTER request for 
a non-VSAM data set? ee 
No Yes SIIICICE error G0. oe 
r 
reason 32 Sn) 
tGGPIOSI 


Does CTGPL catalog record identifier point to 
special catalog open intercept name? 


No 


Yes 





Notes for Diagram DC3 


24, 


28. 


2.60 


If the CAXWA was not found, then the corresponding user-catalog 
must be opened, if an entry exists in the master catalog. 


OPEN recursively calls the search catalog module. Procedure 


IGGPIOS! takes account of OPEN-build case. 


VSE/VSAM VSAM Logic, Volume | 
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Diagram DC4. Search: Retrieve the Base Catalog Record 
















=> 36. 
CCA 
ACB 














1/O support complete? 
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37. 


| 
CAXWA | >> 38. I's early exit indicated? 


number found? 
Yes No 
























records Low key range buffer. 
Object’s 
base record 
ci#t |DSNAME] Datal | 
Catalog 
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Notes for Diagram DC4 


39. If CTGCAT contains a pointer to a 44-character name, it must be the 
data set name of the catalog as contained in the CAXWA. 


If the CTGPL’s catalog record identifier field addresses the record's 
control interval number, the catalog record can be retrieved without 
a search of the catalog’s index. 


The search catalog routine assigns an RPL to the caller. Catalog 
management (CM) routines issue GET and PUT macro instructions 
to retrieve and write catalog records. Each record management 
request (GET, PUT, etc.) needed to satisfy the caller’s CM request 
refers to the RPL. The RPL is initialized for a caller and used as 
often as necessary to process the caller’s CM request. When the 
caller’s CM request is completed, the RPL is assigned to another 
caller. 


40. At this time, the CCA (CCAACB) contains the ACB address of the 


catalog or CRA. 


41. The goal of the search is to find the true-name record identified by 
the DSNAME or the volume serial number. The true-name record 
contains the cluster’s DSNAME or volume serial number and the 
control interval number of the cluster or volume catalog record. 
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35. Set catalog ACB pointer into CCA. | 


mp 2) 


Indicate early exit and OPEN complete. 


interval number and retrieve catalog record. 


Was the catalog record’s control interval 


Read the catalog record from the VSAM 
catalog into a catalog management 


mE F235 
| Object’s base catalog record 
IGGOCLEG 


43. 


Module 


R11 or procedure 


t CCA 


CCA 


CCAACB 










R11 
| toca 























CCA IGGPSCAT 
| _CCAREASN _| 
AXE No Yes eed Return CCAREASN 
t List of CCACD1 
RPLs CCACD2 
available F 
for this 
request Search the VSAM catalog 
ea IGGOCLEG 
‘ < 39. Allocate and initialize an RPL for the IGGPGET 
: i (GGOCLAB 
| | catalog being searched. ) ; eaaen 
CYS 40. Put the catalog’s ACB address into the a IGGOCLAH 
A RPL. \GGPSCAT 
_ 41. Search the catalog’s index and true-name | | CCA IGGOCLEG 
| | records to find the catalog record’s control IGGPGET 


Catalog management buffers 










1GGPGET 


CCACD1 
Return code 


The search catalog routine sets the ‘‘no record found” error code in 
the field CCACD2 of the CCA and returns to the caller. If the VSAM 
catalog has been unsuccessfully searched, the search catalog routine 
returns to the caller with the same error code set. 


See the Diagnostic Aids section of this manual for CM error codes. 


The catalog record is located by its control interval number and read 
into a CM buffer. The buffer’s address is put into the CCA, 
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Diagram DD1. Check the Password 

















































R11 Module or 
CTGPL “Diagrams DB, EB procedure 
Request -— Verify the caller’s authority to 
Password I bypass password checking 
CTGPL checking we: { 
| f Catalog record | options ~~ Does the caller want to bypass password 1GGOCLBM 
eae: ! checking, or is the request a locate for opening IGGPCKAU 
supplied a user catalog? 
ee | No Yes aa ( 12) 
Catalog management buffer | 
Catalog record (retrieved by | - 
the caller) ! Check the user-supplied password 
L Determine the type of password to be checked. 1GGPSPSC 
[Password IGGOCLAZ 
Password 3. Obtain the password from the catalog record. IGGPEXT 





Number of 
attempts 












Field’s Value. 


@s=> 4. 1s there a user-supplied password? 
Yes No 
| ¥ Console 
le x ’ LBM 
eas uest the password Vaeeenee 
operator 


| See Diagram DK1. Obtain a Catalog Record 






Operator reply | 1KQOCN 
z -————"> 6. Does the password in the catalog record equal 1GGOCLBM 
mond the user-supplied password? IGGPPWVR 
No 
7. Did the user exhaust the number of 
rea ee attempts he has to supply the 
password? 
No Yes SE (13) 
Notes for Diagram DD1 Read-only password: The user is allowed to read, but not to write (add 
or update), records in his data set. 
When the VSAM Open routine (IKQOPN) calls VSAM catalog management 
to retrieve a cluster catalog record, the password checking routine 1, If the user’s password has been verified during a previous CM request, 
(IGGOCLBM) confirms the user's authorization to gain access to the the caller (VSAM Open or CMS) can set the CTGPL's bypass-password- 
cluster. checking flag on. 
When an Access Method Services routine calls a catalog management 2. The caller can indicate the minimum level of password to be verified 
services routine (see Diagram EB1, step 1), the password checking routine with the CTGPL, but the password checking routine determines the 
confirms the user’s password to gain access to the VSAM catalog or a type of password required for the request. 


specific catalog record. 
3, The password is in the password group occurrence in the catalog 
The catalog record containing the password (s) is available in the buffer record. 
addressed in the caller’s CCA. 

5, The console operator can reply to the VSAM request for a password 


The type of processing that the user is allowed to do with the data set is message with a password. If the operator replies with CANCEL or 
determined by the password: EOB, error code 56 is returned and module IGGOCLCS9 cancels the 
job. : 


Master password: The user is allowed to modify passwords and catalog 
records that describe his data set, and to process his data set’s control 
intervals and records. 


Control-interval password: The user is allowed to process the data set‘s 
control intervals as well as its records. 


Update password: The user is allowed to process his data set's records. 
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Diagram DD2. Check the Password 










i ifi i j Modul 
RI Call the user security verification routine (USVR) asa Noe 
-—3~ 8. Did step 6 confirm the data set’s master IGGPINMD 
CTGP Password password? USVR 
- checking No Yes 
Catalog options 
record 
Catalog management buffer 9. Is there a USVR specified for the user? 
IGGOCLBM 
IGGPINMD 





Catalog record : 
(retrieved by the caller) Yes No > (12) 


Pasiword Groue CceUrtenice 10. Call the USVR to confirm the user program's 


Ue ee authorization to process the data set’s records. 


# 41. Is the USVR return code 0? 


Yes No GOEp>(13) 
¥ 


e 
R15 (set by USVR) H 
a 


Return to the caller 











CCACD1 


12. Seta return code — successful completion 
— and return to caller. ; 


13. Set an error return code — security verifi- 
cation error — and return to the caller. 


Notes for Diagram DD2 


8. If the user supplied the correct master password, the user security 
verification routine (USVR), if it exists, is bypassed. If a USVR 
exists, the USVR exit is taken even though the user provided another 
type of password correctly. 


9. If auser security verification routine exists for the user, its name 
is in the catalog record’s password group occurrence. 


See ‘Data Areas” for details about the cluster catalog record and 
password group occurrence. 
10. The user security verification routine is an installation-supplied 
routine that confirms a user’s authorization to gain access to the 
data set. The USVR confirms that the user satisfied the installation’s 
security verification criteria. 
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Diagram DE1. Locate: Retrieve Catalog Information 


1. Do steps 2 through 12 to process each of the 


caller’s CTGFLs: 


Test the catalog record field 


2. Is the field to be retrieved only if caller- 
specified test conditions are satisfied? 


om: ) 


Yes No 


Notes for Diagram DE1 


Description Module Procedure 


The VSAM Open routine (LKQOPN) issues the 
CATLG instruction to obtain data set and 
volume information about the user’s data set 
and index. 


The VSAM end-of-volume routine (IKQED xX) 
issues the CATLG macro instruction to obtain 
volume information about the extents added to 
the user’s data set. 


When the caller issues a CATLG macro instruction, 
register 1 points to the caller’s CTGPL. The 
CTGPL.’s request options are decoded and the base 
catalog record is retrieved for the request. 


1, The Locate routine processes each CTGFL IGGOCLAZ IGGPLOC 
associated with the caller’s CTGPL and 

returns as much caller-requested data (in 

the caller’s work area) as the caller’s test 


conditions and work area size permit. 
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Description Module Procedure 


The caller's CTGFL list (CTGFIELD in 

the CTGPL) contains the address of each 
CTGFL required to satisfy the caller’s 

need for catalog information. Each CTGFL 
describes one of the catalog record fields 
to be retrieved. Each CTGFL is completely 
processed before the next one is started. 


A caller might make conditional requests 
for retrieval of catalog record fields. For 
example, a chain of CTGFLs might be 
supplied with the request and processed 
together. The first CTGFL identifies a 
field to be retrieved and points to sub- 
sequent CTGF Ls that contain the names 

of the catalog fields to be tested, the test 
conditions (equal, low, high, etc.) and the 
address and length of the caller's test data 
area. The catalog record fields identified by 
the second and subsequent CTGF Ls are 
compared to (or tested against) the caller's 
data. If the comparison satisfies the test 
conditions, the catalog record field specified 
by the first CTGFL is retrieved. 
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Diagram DE2. Locate: Retrieve Catalog Information 








R11 CTGPL 
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|_t CTGF 
CTGFEL RI 
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CTGFL Field name 


+ _CTGFL for tests 


CTGFL for tests (a) 


[Test condition | Test the catalog record field (con't) 
erred | Fieldname 

Test-Data Area | 

Ct aaa ene patente _Fe 3. Identify each group occurrence that 


satisfies the test conditions. 
t Next | t Next CTGEL for tests tests] JLo ee 







t Current CTGF 


tCTGPL 











Sequence number 
of each group 
occurence that 
satisfies the tests 


















4. Does at least one group occurrence satisfy 
the test condition? 





Objects catalog record 


| Group occurence 









CTGFL 


"Test failed’ 





No 





Yes 







Field to 
be 
tested 


Field to 
be 
retrieved 







Group 
occur- 
rence 
pointer 










Notes for Diagram DE2 


Description Module Procedure 
3. If the caller wants to retrieve a catalog IGGOCLBA  IGGPTSTS 
record’s header field, the field’s data is IGGPGREC 


retrieved if all tests are satisfied. If the 
caller wants to retrieve a field from one 
of the group occurrences that follow the 
header field, the field’s data is retrieved 
from each group occurence that satisfies 
all tests, 


The sequence number of each group 
occurrence that satisfies the tests is put in 
the CCA. When all group occurrences have 
been tested, the sequence numbers in the 
CCA are used to identify each group 
occurrence that contains caller-requested 
data. 


4. If none of the group occurrences satisfy IGGOCLAZ IGGPSCNF 
the test conditions specified by test 
CTGFLs, the next CTGFL in the catalog 
parameter list (CTGPL,) is processed. 
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Diagram DE3. Locate: Retrieve Catalog Information 
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c——> 5. Is more than one field identified by the field 
name (a combination field name) ? 


No Yes 
Z + 
4 6. Do steps 7 through 12 for 
each field associated with the 
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t Buffer 


t Current 
CTGFL 
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* current 
Field name 
CTGFL i ~ combination name. 
~ 
t Buffer t ~, Field name (combination) 
' : : 
ors 7. Does the caller want the address of the catalog’s Field name in the — 
ACB? combination name index 
Number of field names 
e 0 in the combination 
t Yes N Address and length of 
S data in work area 
Lees a ee 


“= §8. Get the field’s value from the 


catalog record. 
See Diagram DK1, Obtain a 






Combination 
name index 


| 











Work area 


Work area’s 
length 
Current total 
length 


Catalog 
field's 
data 


Catalog Record Field’s Value. 





Work area : ? ; 
Put the field’s data in the caller’s work area 
Work area's 
length 





Current total 
length 


9. Add the data field’s length to the current =) 























ie. total length. 
eae Catalog management buffer 
data i 10. Is the current total length greater than the 
ag work area length? Object’s catalog record 
Field to 
be 
Yes No retrieved 
Notes for Diagram DE3 Description Module Procedure 
Description Module Procedure 7. The address of the catalog’s ACB isin IGGOCLAZ IGGPLOC2 
5. Acombination naine refers toa set IGGOCLAZ IGGPLOC2 the 6 CAs AlLother catalog record 


fields that the caller can request are 


of related catalog tieid names, and . 
9 in the catalog record. Each catalog 


is used by the caller instead of a 


separate CTGFI for each field name. peecord Held feign yl 
field name. 
: inati i I Z IGGPLOC2 : 
: es er ee a tae ote 8. Diagram DK1 shows iow the IGGOCLBA IGGPGVAL 
combination, The Lonere routine requested catalog record field (spe- IGGPGREC 


cified by its field name in the 


h fier i 
Proceenes eect field name -entry: i CTGEFL) is located for the Locate 


the combination narne index 


sequentially, starting at the address FOULING: 

of the first field name entry for 9. The first two fields in the caller's IGGOCLAZ IGGPLOC2 
the combination, and ending when work area specify the number of IGGPSHIN 
the number of entries processed bytes the caller allocated to the work 

equals the number of field names area and the number of bytes that 

associated with the combination contain catalog record field data (the 

name. current total length field). 


10. If the current total length exceeds IGGOCLAZ IGGPSHIN 
the work area length, the current 
total length field is updated with the 
length of the catalog record data, 
but the data itself is not moved in 
the caller’s work area. 


The test sequence, if any, associated 
with a combination-name CTGFL is 
done only once, not once for each 
field name in the combination. 
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Diagram DE4. Locate: Retrieve Catalog Information 













Object's catalog 





Catalog management buffer 





record 


Group occurrence | 


Other 
fields 









Group 
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rence 

pointer 











Field to 
be 
retrieved 


Notes for Diagram DE4 


11, 


12, 


13, 


Description 


The Locate routine puts the beginning 
address and the length of the catalog field 
into the CTGFL’s field-data entry. 


The CTGFL’s field-data entry contains the 
beginning address and length of the data in 
the caller’s work area. When control is 
returned to the caller, the caller can use the 
field-data entry to locate a specific field's 
data in the work area. 


If the dictionary information indicates that 
the field value is to be returned in fixed 
block format (units of blocks rather than 
tracks and/or cylinders), translate the field 
value, 
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Put the field’s data in the caller’s work area 
(con't) 











Move the field's data into the 
work area. 


12. Put the data’s length and ===>) 
address into the CTGFL. 


Translate field into fixed block format, 
if applicable. 


Have all CTGFLs been processed? 


Yes No (2 ) 





CCACD1 


Return 


Module Procedure 


IGGOCLAZ IGGPSHIN 


IGGOCLAZ IGGPSHIN 


IGGOCLEZ IGGPLTRN 
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Diagram DG1. Update: Modify Catalog Information 


































































Work area 


Caller-supplied 
update data 

to replace 
catalog 

record 

data 


No Yes 


Catalog record 


VOLSER of CRA 


Notes for Diagram DG1 


The VSAM Close routine (IKQCLO) issues the CATLG macro instruction 
to modify the data set and index statistics maintained in the catalog 
record’s copy of the AMDSB. 


The VSAM ‘‘Get new extent” routine (IKONEX) issues the CATLG 
Macro instruction to obtain more space for a data set. 


When the caller issues the CATLG macro instruction, register 1 points 
to the caller’s CTGPL. The CTGPL request options are decoded, and the 
base catalog record is retrieved for the request. 


1. If this is a call to release secondary extents (for a reusable data set), 
routine IGGPRELE in module |GGOCLCB is called. 


2. This information is saved in order to be able to supply it for extension 
records. 


3. If more space is required for the data set, the UPDATE-Extend 
routine (IGGOCLBB) processes the caller’s Update request and 
returns directly to the caller (the VSAM ‘Get new extent” routine). 
See Diagram DH for information about UPDATE-Extend processing. 


4. Scan through the dictionary information of all fields to be updated. 
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4. Check the inhibit update bit in the dictionary 
entry of each field to be updated. 


5. Are all inhibit update bits set? 


6. Set inhibit update bit in CCA. 


5. 






























Module or 
R11 (a> Does the caller want to release extents? R11 Procedure 
No Yes IGGOCLAV 
IGGPUPD 
CCA (2) CCA 
eTGEL See Diagram DM. Release Extents. CTGFL 
x 7 
CTGFL 2. Save the serial number of the volume contain- Stara 1GGPSFPL 
CTGPL ing the current CRA. “OK" group 
occurrences 
CTGELs for tests C72 3 ‘|s this nha from aed Get next extent > CCAVOLCR iGGPUPD 
‘ danilfieg (a) routine for more space? SCARPUT 
a catalog No Yes 
record Address and 
Request length of the 
options test data See Diagram DH1. Update Extend: 
CTGFL Obtain Additional Space for a 
VSAM Object. 
{GGPSFPL 


If there are one or more fields in the list that require CRA update, the 
inhibit CRA update bit in the CCA (which was initially set ‘“‘on’’) is 
cleared. 


Steps 7 through 12 are performed to update each of the catalog record 


fields identified by the caller’s CTGFL. 
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Diagram DG2. Update: Modify Catalog Information 
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it Buffer | numbers of 
No Yes “OK" group 
occurrences 
: aes? 
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to replace 
catalog 
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data 







Notes for Diagram DG2 


7. The caller's CTGFL list (CTGFIELD in the CTGPL) contains the 
address of each CTGFL needed to satisfy the caller’s updating require- 
ments. Each CTGFL describes one of the catalog record fields to be 
updated. Each CTGFL is completely processed before the next one is 
started. 


The caller may want to update a field only if another field’s value, 
when compared to the caller’s test value, satisfies the caller's test 
conditions. If so, the caller builds a CTGFL that contains the name 
of the catalog field to be tested, the test conditions (equal, high, low, 
etc.), and the address and Jength of the caller's test value. If a CTGFL 
contains the address of another CTGFL, the second CTGF L describes 
a catalog record field that is to be compared to the caller's data. If 
the comparison satisfies the test conditions, the catalog record field 
specified by the first CTGFL is updated with the caller’s data. 


8. If the caller wants to update a catalog record’s header field, the field’s 
data is updated with the caller's data if all tests are satisfied. 


If the caller wants to update a field from one of the group occurrences 
that follow the header field, the field’s data is updated with the 
caller's data for each group occurrence field that satisfies all tests. 

The group occurrence that contains the field to be updated can also 
be identified by its sequence number. 
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9. Does at least one group occurrence 
satisfy the test conditions? 







The sequence number of each group occurrence that satisfies the 
tests is put in the CCA. When all group occurrences have been 
tested, the sequence numbers are used to identify each group 
occurrence that contains caller-requested data. 
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Diagram DG3. Update: Modify Catalog Information 
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7 update data. 
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catalog. 
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Return 


Notes for Diagram DG3 


10. A combination name refers to a set of related catalog field names, 
and is used by the caller instead of a separate CTGFL for each field 
name, 


11. The CCA’s combination name index has an entry for each field name 
in the combination. The Update routine processes each field name 
entry in the combination name index sequentially, starting at the 
address of the first field name entry for the combination, and ending 
when the number of entries processed equals the number of field 
names associated with the combination name. 


The combination name's CTGFL contains the beginning address 
and the total length of the group of update data fields in the 
caller’s work area. 


The test sequence, if any, associated with a combination-name 
CTGEL is done only once, not once for each field name in the 
combination. 


13. When the catalog record is updated (in a buffer in the Update 
routine’s virtual storage), the Update routine sets the ‘must write’ 
flag on to indicate that the |/O manager must write the buffer from 
storage into the catalog before the buffer can be made available to 
contain another catalog record. When the caller’s Update routine 
needs the buffer to process another catalog record associated with 
the request, the Update routine writes the catalog record from the 
buffer into the VSAM catalog (on a direct-access storage device). 
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10. ts more than one field identified by the field 
name (a combination name)? 


11. Do step 12 for each field associated 
with the combination name. 
Replace the field‘s data with the caller’s 

See Diagram DL1, Modify a Catalog Record. 
13. Write the updated catalog record into the 


14. Have all CTGFLs been processed? 


Module or 
procedure 


|}GGOCLAX 
IGGPALT2 














Update routine’s buffer 


Catalog record 
Updated data 















IGGOCLAW 
Updated catalog IGGPPREC 
record {GGOCLEG 

1GGPPUPC 

|GGPPAD 








CCACD1 


Note: If the catalog is recoverable, the call to IGGOCLEG will result 
in a CRA update unless bit CCARPUT (the update inhibit bit) is 

set to ‘1’. This bit is set in the calling procedures, which decide 
whether CRA updating is necessary for a given operation. 


Licensed Material — Property of IBM 


Diagram DH1. Update-Extend: Obtain Additional Space For a VSAM 
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iti high CCHH 
the additional space. gaan | : SALPARL 


Allocate space to the data set 


Cl #f of object's 
catalog record 





Does the object share its VSAM data space 
with other VSAM objects? 


Amount of space 
requested 
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Unique Nonunique number of 
data data set extents allowed 

Volume information set 
group occurrence 

Extent 
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Volume 
serial 


4. Allocate space to thé object 
from the data space’s free space. 


See Diagram DJ1, Suballocate: 


Obtain Additional Space from a 
Nonunique VSAM Data Space. 


numbers 





VSAM Direct-Access 


yy Volume 














eA 5. Did the data space contain enough ee te a 
L “4 free space to satisfy the request? Space {ft 
Qi fv ee 
Return from Suballocate: 7 
7 Free space 
SALPARL User list vA 
-~/ 
Extent 6. Set error code. CCACD1 
valle 
values 
Return 
Notes for Diagram DH1 Description Module Procedure 
Description Module Procedure 4. If the object shares its data space with IGGOCLBB IGGPUPDE 
other VSAM data sets or indexes, there IGGPCSAL 
The UPDATE-Extend routine is called whenever might be enough free space in one of the IGGOCLAR IGGPSALL 
a VSAM object (data set, index, or catalog) needs data spaces on the volume to satisfy the 
more space to store its records. object's direct-access space allocation 
requirements. 
The VSAM “‘Get new extent’ routine calls the CM 
Update routine, and an amount of space (based on 
the object’s direct-access space allocation require- 
ments) is allocated from a shared VSAM data 
space that has enough free space to satisfy the 
allocation requirements. IGGOCLBB IGGPUPDE 
IGGOCLBC IGGPINIT 
2. The volume information group occurrence IGGOCLAZ IGGPEXT 
is identified by either an RBA or a key IGGOCLBB !GGPUPDE 
value. IGGOCLBC IGGPSVOL 
3. A shared (nonunique) VSAM data space IGGOCLBB !GGPUPDE 
contains all or parts of two or more IGGPUALL 
VSAM objects. A unique VSAM data IGGOCLEG IGGPGET 


space contains all or part of only one 
VSAM object, and is not allowed to 
contain records of another object. 
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Section 2. Method of Operation 
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Diagram DH2. Update-Extend: Obtain Additional Space for a VSAM 


Object 
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7. Update the statistics in the AMDSB group 
occurrence. 


Cr 8. Compute the extent values, determine the new 
high RBA, and calculate the extent range for 
each extent in the newly allocated space. 
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—-— > 9. Does the volume information group occurrence 
located by step 2 describe a candidate volume? 
Low and high 
CCHH values 
for each extent No Yes 
allocated to 
the VSAM object 


=> 10. Add new extent descriptors to 
the volume information group 
occurrence. 


See Diagram DL1, Modify the 
Catalog Record - add a new group 
occurrence to the record. 


mp>('2) 


11. Update the volume information group 
occurrence to show the object’s newly 
obtained space. 


See Diagram DL2, Modify the Catalog Record: 
change a field within a group occurrence. 


we ere ee er em nm eer m7? 





VSAM catalog 




















Updated data 
catalog record 






Notes for Diagram DH2 
Description Module Procedure 


7. The object's catalog record contains a IGGOCLBB IGGPMVOL 
volume information group occurrence to IGGOCLAV IGGPMOD 
describe the object’s space on each volume 
that contains a part of the object. If the 
object’s newly obtained extent is on anew 
volume, the UPDATE-Extend routine 
builds a volume information group 
occurrence to describe the new volume 
and extent. Otherwise, an existing volume 
information group occurrence is updated 
with the high-allocated RBA and extent 
information in the form: 


SS CCHH CCHH DDDD DDDD 

where: 
SS identifies the VSAM data space 
CCHH are the low and high cylinder and 
track addresses 
DDDD are the low and high RBAs 
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Diagram DH3. Update-extend: Obtain Additional Space for a VSAM 
Object 
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set 

For the data For the index 
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descriptor descriptor 

Notes for Diagram DH3 
Description Module Procedure 


14. The low and high addresses in the index IGGOCLBB IGGPSSWD 
catalog record’s volume information group IGGOCLEG IGGPGET 
occurrence are those of the extent obtained IGGOCLBB iGGPSSWD 
for the data set. The low and high RBA IGGOCLBC !GGPINIT 
values are for the sequence set. IGGOCLBB iGGPSSWD 

IGGOCLBC !IGGPSVOL 
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Diagram DJ1. Suballocate: Obtain Additional Space From a Nonunique 
VSAM Data Space 
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3. Does the volume catalog record contain a 
Data Set Directory entry that describes the 
object? 
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4. Build a Data Set Directory entry to 
On describe the object. 


See Diagram DL1, Modify a Catalog Record 
Field’s Value (add a new group occurrence 
to the record). 
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Volume catalog record 


Data set directory entry 
Cl #fof object's catalog 
record 












Updated volume 
catalog record 





Catalog LUB 







CCACD1 


Return 


VSAM catalog 






t VSAM catalog 


Volume catalog 
record 


Notes for Diagram DJ1 


Description Module Procedure 
Description Module Procedure 2. The volume must be owned by the same IGGOCLAR IGGPSALL 
catalog that contains the object. IGGOCLEG IGGPGET 
The suballocate routine, |GGOCLAR, is called to 
assign a candidate volume to a VSAM object (data 3. The volume catalog record already IGGOCLAR IGGPSALL 
set, index, or catalog) and to assign available spaces contains a data set directory entry, the IGGOCLAZ IGGPEXT 


on the caller-specified volume. The caller, either 
the UPDATE-Extend routine (Diagram DH) or 
the DEFINE Cluster routine (Diagram ED) 


volume is either already assigned to the 
VSAM object as a candidate volume or 
has some of its space allocated to the 


builds a list of volume serial numbers to identify VSAM object. 
each volume to be assigned to the object as a IGGOCLAR IGGPSALL 
candidate volume. If the caller requests space 4, The new data set directory is added to the IGGOCLAG IGGPISCI 


allocated to the object, the list contains one 


volume catalog record. IGGOCLAR IGGPSALL 
volume serial number. 


IGGOCLAV IGGPMOD 


Note: Although space requests on FBA devices 
are externally specified in BLOCKS (or 
RECORDS), catalog management processes 
them as track and cylinder addresses. 


1, Acandidate volume is available to contain IGGOCLAR !GGPSALL 
a VSAM object's catalog records, but no 
space is allocated to the data space from 
the volume as yet. 
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Diagram DJ2. Suballocate: Obtain Additional Space From a Nonunique 
VSAM Data Space 
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Notes for Diagram DJ2 


Description Module Procedure 
5. If the amount of space requested is a IGGOCLAR IGGPSALL 
number of cylinders, convert it to a IGGOCLAU IGGPSALS 


number of tracks. 


6. The extent table is built by retrievingeach tGGOCLAZ {!GGPEXT 
extent descriptor (from each data space 
occurrence) that might contain enough free 
space to satisfy the request’s minimum 
allocation requirement (the number of 
tracks in one control area). 
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Diagram DJ3. Suballocate: Obtain Additional Space From a Nonunique 


VSAM Data Space 


Process each extent in the extent table: R11 


O=——-75- 


xamine the space map group occurrence. —— — 







Notes for Diagram DJ3 


Description Module Procedure 
7. Each extent descriptor in the extent table 
is processed beginning with the lowest 
extent starting track number (TT) in the 

table, in ascending sequence, until all 


extent descriptors have been processed. 


IGGOCLAU IGGPSALS 
IGGPEDS 


IGGOCLBR IGGPBMR 


(GGPBMR examines each extent to find 
an amount of contiguous unallocated 
tracks at least as large as the request’s 
minimum allocation unit. |GGPBMR 
examines the space map group occurrence, 
starting at bit position TT (track indicator) 
and ending at bit position TT plus the 
number of tracks in the extent (NN) minus 
1. If |GGPBMR finds a large enough 
amount of unallocated tracks, it returns to 
IGGPEDS with the beginning track 
number (TT) and the number of tracks 
(NN). If the data space’s extent contains 
another amount of unallocated tracks at 
least as large as the request’s minimum 
allocation unit, IGGPEDS calls IGGPBMR 
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| If the extent obtained by step 7: 


8. Exactly satisfies the request, no further 
extent-table processing occurs. 


8. 
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Extent save 
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Data space 
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+ Buffer 
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Volume catalog record 


Parameters to |IGGPBMR 






Minimum 
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unit size 


Starting TT 
value of extent 
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roe a we wn caer caernranranraan es 


Module 


Description 


Procedure 


to examine the rest of the data space’s 
extent. 


If the extent returned by IGGPBMR is the 
exact number of tracks required to satisfy 
the caller's request, no further extent table 
processing is done. Larger or smaller 
extents obtained from previous extent table 
entries are ignored. 


IGGOCLAU IGGPEDS 
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Diagram DJ4. Suballocate: Obtain Additional Space From a Nonunique’ 


VSAM Data Space 


Process each extent in the extent table (cont’) 





If the extent obtained by step 7: 


(Is greater than the amount of tracks 
requested, if a previous ‘‘larger extent” 


ee) 


was found and if the currently obtained 
extent is smaller than the previously 
obtained one, the current extent is saved. 


Is less than the amount of tracks 
requested, save it. 


—— ) 





Notes for Diagram DJ4 


9. 


10. 


Description Module Procedure 


If the extent returned by IGGPBMR is IGGOCLAU IGGPEDS 
larger than the amount of tracks required 

to satisfy the request, the extent is saved if 

either: 


@ No other larger-than-requested-amount 
extent has been returned yet, or 


e@ The current extent is smaller than a 
previously obtained larger-than- 
requested-amount extent. 


In either case, only one larger-than- 
requested-amount extent value is saved. 
The small extent table (built in step 10) 
is ignored and no longer used. 

If the extent returned by |GGPBMR is IGGOCLAU !IGGPEDS 
smaller than the amount of tracks required 

to satisfy the request, its TTNN value is 

adjusted so that TT isonacylinder ° 

boundary. If NN is now at least as large 
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Description Module 
as the request’s minimum allocation unit 

(number of tracks for one control area), 

the extent is saved in the small extent table 

if: 


@ The table has fewer than five entries 
(or a caller-specified maximum less 
than five) in it, or 


e The table is full and the current 
extent’s NN value is greater than the 
table’s smallest extent. The current 
extent replaces the table’s smallest 
extent. 


In either case, the extent is not put in the 
small extent table if it is too small (adjusted 
NN is less than the minimum allocation unit) 
or if a larger-than-requested-amount extent 
already exists (see step 9). 


if, after all data spaces have been examined, 
the total of the NN values in the small extent 
table is less than the amount required to satisfy 
the request, no space is allocated to the object. 


Section 2. Method of Operation 


Procedure 


2.77 


Diagram DJ5. Suballocate: Obtain Additional Space From a Nonunique 


VSAM Data Space 


Allocate the space to the object: 








Notes for Diagram DJ5 
Description 


11, If the selected extent is larger than or 
equal to the amount of space requested, 
IGGPBMR adjusts the space map group 
occurrence starting at bit position TT 
(track indicator) by turning off NN bits 
(NN is the exact number of tracks required 
to satisfy the request). 


If the space is allocated to an object from 
a number of extents, the small extent table 
is sorted so that the largest NN value is 
first, the smallest last. |GGPBMR then 
adjusts the space map group occurrence 
for each TTNN value in the small extent 
table, until the amount of allocated tracks 
equals the amount of tracks requested. 


12, IGGPSALS returns the sequence number 
of the data space’s extent, starting track 
number, and number of tracks of each 
extent obtained for the request. The caller 
uses this information to build extent 
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Module 


R11 
11. Reset the space map group occurrence to =) 
show the newly allocated tracks. 


12. Store information about extent(s) 


obtained into CCA. 


Return 


Procedure 


IGGOCLAU 1GGPSALS 
IGGOCLBR IGGPBMR 


{GGOCLAU IGGPSALS 










Seq. no. of 
data space’s extent 





Starting track no. 


No. of tracks of each 
extent obtained 
for request 





Module 


Procedure 


Description 


descriptor entries in the VSAM object's 
volume information group occurrence. 
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Diagram DK1. Obtain a Catalog Record Field’s Value 







cle estes Sp 1. 





CTGFL’s field 
name 


Notes for Diagram DK1 


Description Module 
The obtain-field-value routine is called by other 

catalog management (CM) routines to obtain the 
location and length of a field in a catalog record. 

The record is in a CM buffer in main storage. The 
following results could occur: 


e The field is entirely contained in the record 
in the buffer, and the field’s address and 
length are set in the caller’s CCA. 


e The field is partially contained in the 
record in the buffer, and the field's address 
and partial length are set in the caller’s 
CCA. The CCA also has the ‘‘not complete” 
flag on and contains the control-interval 
number of the catalog record’s extension, 
which contains more of the field. 


© §=The field is not retrieved because it 
doesn't exist in the caller-specified group 
occurrence, or because there are no more 
group occurrences in the record, or because 
no buffer space is available to contain 
extension record. 
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header field? 


No 


Extract header field data 
Does the CTGFL’s field name identify a 


Yes 


, catalog record 
2. Set the header field’s address Side GREETS 
and length in the CCA. length [ CCACPE1x | 
and address CCACPE2x 
CCACPE3x 
CCACD1 Extension CCACPE4x 
on CCACPESx 
| CCACPE6x_| 
Catalog [CCACPETx_] 
record 


Procedure 


Return 


*Diagrams DD, DE, DI, EH, El 














Addresses of 
parts of the 













CCA 









































Catalog management buffer 


Description Module Procedure 
The derived volume entry fields are IGGOCLBS IGGPXVAL 
retrieved. 

The field-name dictionary is a read-only IGGOCLBA |IGGPGVAL 


catalog management table. The catalog field 
name dictionary contains an entry for each 
type of catalog record field, based on its field 
name. The caller puts the dictionary entry 
identified by the CTGFL’s field name into 
the CCA before calling the obtain-field-value 
routine. 


If the field name identifies a header field, the 
field’s type code (in its dictionary entry) is 0. 
A nonzero group code identifies the group 
occurrence that contains the field identified 
by the CTGFL/’s field name. 


If the field name identifies a header field and 
the field is fixed-length, it is at a fixed displace- 
ment from the beginning of the catalog record. 


The field’s address is obtained by adding the 
displacement in the CTGFL’s dictionary entry 
to the beginning address of the record (the 
contents of CCACPE1x). The field’s length is 
part of the CTGFL’s dictionary entry. 


Section 2. Method of Operation 2.79 


Diagram DK2. Obtain a Catalog Record Field’s Value 
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o Not found flag 


CCACD1 
Return code 
Return 


So 


Procedure 


Notes for Diagram DK2 


Description Module Procedure 


3, The group occurrence pointer (GOP) is IGGOCLBA IGGPLVAL 
used to locate a group occurrence. The 
GOPs are grouped together by a group 
code. Within each group of GOPs, the 
pointers are ordered by sequence number. 
If the caller-specified GOP, identified by IGGOCLBA IGGPLVAL 
its sequence number, is found, its displace- 

ment field and flag field specify the location 

of its group occurrence as: 


® The number of bytes from the beginning 
of the record’s group occurrences (the 
contents of CCACPE3x plus the GOP’s 
displacement field value), or 


® The control-interval number of the 
extension record that contains the group 
occurrence. The extension record contains 
a GOP that specifies the group occurrence’s 
location as a number of bytes from the 
beginning of the record’s group occurrences. 
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Description Module 


The actual group occurrences containing IGGOCLBA IGGPLVAL 
the field to be retrieved may be contained 


in an extension record. 
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Diagram DK3. Obtain a Catalog Record Field’s Value 
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Read the extension record into a catalog | | 
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Extension 
record's 
cl # 






Notes for Diagram DK3 Description Module Procedure 
Description Module Procedure occurrence is contained on that extension 
record. 
6. Each catalog record in the CM buffer is IGGOCLBA IGGPGREC 
identified by a record area block (RAB) IGGOCLAW IGGPPREC 9. See step 6. 
within the CCA. The RAB contains flags IGGOCLBA IGGPGREC 
that indicate whether or not the buffer can IGGOCLEG IGGPGET 10, See step 7. 


be used to contain another record. If the 
RAB's ‘must write’ flag is on, the buffer 
cannot be used for another record until its 
contents have been written into the catalog. 


Each CCA contains six record area blocks IGGOCLBA IGGPLVAL 
(RABs). Each CM request can use a maxi- 

mum of five buffers. If all buffers are filled 

and cannot be released, the obtain-field- 

value routine sets the CCA’s “no buffer 

space”’ flag on. 


7. The CCA‘s not found flag is set off before IGGOCLBA IGGPGREC 
returning to step 3 to examine the IGGOCLEG IGGPGET 
extension record’s GOPs. 


8, If the GOP contains the control-interval IGGOCLBA IGGPGVAL 
number of an extension record, the group 
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Diagram DK4. Obtain a Catalog Record Field’s Value 


R11 


CCA 


Extension 
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field's address and length. 





12. 1s the field variable-length and partially 
contained in an extension record? 
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t Catalog 
record CCACD1 
tele Return 
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, number in the CCA. 
“Not complete” fla ccACD1 


eturn 


Notes for Diagram DK4 Description Module Procedure 


Description Module Procedure The caller can move that part of the field 
currently in the buffer into a work area. 
11. The field’s length is obtained from the IGGOCLBA !IGGPLVAL If the rest of the field is required, the caller 
CTGFL’s dictionary entry (for a fixed- can return to IGGOCLBA to retrieve the 
length field) or the first two bytes of extension record. 


the field (which are the length bytes of a 
variable length field). The field’s address 
is the sum of the address of the group 
occurrence and the number of bytes from 
the beginning of the group occurrence. 
12, A variable-length field might be partially IGGOCLBA IGGPGVAL 
contained in an extension record. If so, 
the field’s length is greater than the number 
of bytes remaining in the record. 


13, The caller’s information requirements might IGGOCLBA IGGPLVAL 
be satisfied with the part of the field that 

is currently available. If not, the caller (a 

CM routine) returns to |GGOCLBA to obtain 

the value of the next part of the field from 


the extension record. 
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Diagram DLI. Modify a Catalog Record Field’s Value 
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Examine the group occurrence pointers. Is there 
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record. 





Group 
occurrence 


. Ss 
pointers occurrences | space 


ee ee we we ee we ee ee ee we ee es ee ee ee es ae od 





CCACPE5x 
(tCurrent GOP) 


CCACPE7x 
(t Current field) 
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Notes for Diagram DL1 


Description 


1. The modify routine initializes each 
CTGFL with the dictionary entry 
associated with the CTGFL’s field-name 
value. 


2. The field parameter list (CTGFL) con- 
tains the field's name, type code, length, 
and displacement from the beginning of 
the record or group occurrence. If the 
field exists, it is either a header field 
(group code Q) or a field within a group 
occurrence. If the caller supplied 
modifying data and test conditions, the 
field is being altered. If the caller sup- 
plied modifying data and no test condi- 
tions, a group occurrence is to be added 
to the records. If the caller identified a 
group occurrence combination field 
name but didn't supply modifying data, 
the group occurrence is being deleted. 


3. Anew group occurrence requires a group 
occurrence pointer (GOP). 


x 


No 


new group occurrence’s group code? 


Build a new group occur- p>) 
rence pointer and insert it 


into the existing group occur- 
rence pointers in sequence 


number order. 








Description Module Procedure 
Module Proceduré 4. Itfanew GOP is built, it is put into the IGGOCLBA IGGPGREC 
‘ catalog record at the end of its group of IGGOCLAW IGGPADGO 
IGGOCLAV !GGPMOD GOPs. The GOPs are grouped by group IGGOCLAG IGGPAXCI 
IGGOCLAY IGGPSCNC code and, within the group-code group, IGGOCLAW IGGPADGO 
are ordered by sequence number. IGGPGREL 
IGGOCLBA IGGPGREC 
IGGOCLAV {GGPMOD If the new GOP causes the catalog record 
IGGPSFPL to overflow, an extension record is 
IGGOCLBA IGGPTSTS obtained from the catalog’s free control 
IGGOCLAV  IGGPSFPL intervals. All group occurrences in the 
IGGOCLBT  IGGPXLT2 Original record are put into the extension 
IGGOCLAV. IGGPSFPL record, The GOPs displacement value (in 
IGGOCLBT IGGPXDGO the original record) is replaced with the 
IGGOCLAV IGGPSFPL control interval number of the extension 
IGGOCLBT  IGGPXEL2 record. In addition, a GOP is built and 
IGGOCLAV !GGPSFPL put into the extension record for each 
IGGOCLBA IGGPGREC group occurrence in the extension record. 
The GOP in the extension record contains 
the displacement from the beginning of 
the record to its group occurrence. 
If the new GOP causes the catalog record 
IGGOCLAV IGGPSFPL to overflow and the catalog record con- 
IGGOCLAW 1!GGPADGO tains only GOPs, an extension record is 
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obtained to contain the new GOP. The 
original record’s extension field contains 
the control interval number of the 
extension record. 
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Diagram DL2. Modify a Catalog Record Field’s Value 
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Notes for Diagram DL2 Description Module Procedure 
Description Module Procedure 11. The CCACPE7x field contains the field’s IGGOCLAX IGGPALT2 
address. The CTGFL contains the {IGGOCLBA  [IGGPGVAL 
Be . ; : ; IGGOCLAW IGGPAGOP address and length of the data with 
This routine activates the GOP by setting IGGOCLAG IGGPAXCI skieh: tanapdarathedtibld 
its inactive flag off. IGGOCLAW 1IGGPAGOP P 
IGGOCLBA IGGPGREC 12. The CTGFL flags field (from the catalog IGGOCLAX IGGPALT2 
IGGOCLAW IGGPAGOP field name directory) specifies field type. 
eenctay ee coe 13. The CTGFL contains the length and  IGGOCLAX IGGPALT2 
IGGPIGOP address of the updating data. The data 
is in the caller’s work area. 
6. The new group occurrence contains IGGOCLAW {!GGPADGO 


fixed-length fields and, possibly, 
variable-length fields. tf the new group 
occurrence causes the record to overflow, 
an extension record is obtained to con- 
tain the new group occurrence. 


8. Replace the initial field values (from IGGOCLAW IGGPADGO 
step 6) with the caller-supplied values IGGPMVGO 
addressed by the CCA. 


9, If there are no more CTGFLs to process, IGGOCLAV IGGPSFPL 
IGGPSFPL calls IGGPPREC to write IGGOCLAW  IGGPPREC 
each updated catalog record into the 
catalog. 
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Diagram DL3. Modify a Catalog Record Field’s Value 


Notes for Diagram DL2 
Description 


14. The CTGFL flags field (from the cata- 
log field name directory) specifies field 
type. If the length of the data to update 
the field within the CTGFL isn’t equal 
to the field’s length in the CCA, the 
variable-length field’s length is either 
increased or decreased, causing a 
corresponding reduction or increase in 
the catalog record’s amount of free 
space. 


Note: If the catalog is recoverable, the 
call to |GGOCLAG or IGGOCLEG will 
result in a CRA update unless bit 
CCARPUT (the update inhibit bit) is 
set in the calling procedures, which 
decide whether CRA updating is nec- 
essary for a given operation. 
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IGGOCLBW 


IGGOCLAG 
IGGOCLBW 


IGGOCLAG 
IGGOCLBW 
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Procedure 


IGGPALT2 
IGGPMVAR 
|GGPMBGO 
IGGPMVAR 
IGGPGVAL 
IGGPMVAR 
IGGPAXCI 
IGGPMVAR 
IGGPGNEX 
IGGPMVAR 
IGGPGREC 
IGGPMVAR 
IGGPMGO 
IGGPMVAR 
IGGPDEIN 
IGGPRISE 
IGGPAXCI 
IGGPRISE 
IGGPGVAL 
IGGPRISE 
IGGPSHNK 
IGGPRISE 
IGGPPREC 
IGGPDEIN 
IGGPSINK 
IGGPSHNK 
IGGPSINK 
IGGPEXPD 
IGGPDEIN 
IGGPSNK2 
IGGPAXCI 
IGGPSNK2 
IGGPDOWN 
IGGPAXC}I 
IGGPDOWN 


Description 


Module 


IGGOCLBA 

IGGOCLBW 
1GGOCLAW 
IGGOCLBW 
IGGOCLAX 
IGGOCLBW 
IGGOCLAX 
IGGOCLBW 
IGGOCLAW 
IGGOCLBW 
IGGOCLAW 
IGGOCLBW 
IGGOCLBA 

IGGOCLBW 
IGGOCLEG 

IGGOCLBW 
IGGOCLBA 


If the modification occurs in a base cata- IGGOCLAX 
log record, the affected group occurrence IGGOCLAG 


is moved from the base catalog record 
into an extension record. If the available 
space pointer doesn't have an extension 


IGGOCLAX 


control interval number, an extension con- 


tro! interval number is assigned to the 


caller. 


The length of the group occurrence to be IGGOCLAX 


moved is computed. The group occur- 
rence and the GOPs are moved and 


updated. 


The variable-length field’s length bytes 
are replaced with the length of the data 
with which to update the field (in the 


CTGFL). 


IGGOCLAV 
IGGOCLAX 
IGGOCLAW 


IGGOCLAX 


Procedure 


IGGPGVAL 
IGGPDOWN 
IGGPGNEX 
IGGPDOWN 
IGGPSHNK 
1GGPDOWN 
IGGPEXPD 
IGGPDOWN 
IGGPPREC 
IGGPSNK2 
IGGPPREC 
IGGPSNK2 
IGGPGREC 
IGGPSNK2 
IGGPPDE 
IGGPDEIN 
IGGPGVAL 


IGGPMBGO 
IGGPAXCI 
1IGGPMBGO 
IGGPMGO 


IGGPMGO 
1GGPSGOP 
IGGPMGO 
IGGPIGOP 


1GGPMGO 
IGGPCGO 
1IGGPMGO 
IGGPDGO 
iGGPMGO 
IGGPDGOP 
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Diagram DL4. Modify a Catalog Record Field’s Value 


Change a field within a group occurence (con't): 
If the field length is: 


Reduced: © 
15. Shift the other fields to the left by the | 








number of eliminated bytes. 
Increased: 


16. Shift the other fields to the right by the————>_) 
number of additional bytes. 













group occur- 
rence pointers 









Can the record's free space contain the new 
or updated group occurrence’s field? 


No Yes 


+ available record as an extension to ———— 
the catalog record. | | 

Move the original record’s data from the =) 
original into the extension until there is 

enough free space in the original record for 
the expansion. 


Update all group occurrence pointers =) 
that are affected by the split. 


a ee 





VSAM 
catalog 















Original record 
Extension 
record 


Other part 
New group | 9f the 
occurrence | Original 


; record’s 
ointers 
m o data 














(2°) 


Notes for Diagram DL4 Description Module Procedure 


Description Module Procedure which the requests are filled from the 
free record chain. 
15. The eliminated bytes at the end of the IGGOCLAX IGGPMVAR 
record are added to the record's free IGGPSHNK 19. The group occurrence data is split so that |GGOCLAX IGGPALT2 
space, part remains in the original record and 
part is moved into the extension record. 
16. The additional bytes are obtained by IGGOCLAX IGGPMVAR 
reducing the record's free space. IGGPEXPD 20. Each GOP is updated to show the new IGGOCLAX IGGPALT2 
position of its group occurrence. 
lf the increased length causes the catalog 
record to overflow, an extension record 
is obtained. The original record’s data is 
split so that part remains in the original 
record and part is moved into the exten- 
sion record, Each associated GOP is 
updated to show the new position of its 
group occurrence. 


18. The catalog control record (CCR) con- IGGOCLAX IGGPALT2 
tains pointers to two chains: one of 
unassigned records (Cls) and one of 
free (F type) records. The unassigned 
records are used first, down to a mini- 
mum “‘reserve”’ of 4 (needed for cata- 
log extension), after which the requests 
are filled from the free record chain. 
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Diagram DLS. Modify a Catalog Record Field’s Value 


R11 


Delete a group occurrence: 


R11 
( W oe 21. Deactivate the group occurrence pointer. | 


Field's 
address 
and 
length 
Updated 
catalog 
record 


+ Extension 
record 


Group 
occurrence Group occurrences 
pointers 





Buffer 


Catalog record 


























Release an extension record 


22. !s the deleted group occurrence the only one 
in an extension record? 


ry No > (26) 


23. Delete the extension record's control interval 
number from the record to which the 
extension record belongs. 


Buffers 
















Free space 


) ors Group occurrences 









Group occurrence 
pointer 

Flag: Displacement 
inactive | set to 0 


















24. Update the extension record to reclassify it 
as a free catalog record. 










| | Catalog record being updated 








roup occur- 


rence pointer 
NExtension 
record 
set to 0 





Extension 
record 
pointer 


Set to 0 











25. Update the catalog control record to show 
one more free record. 

















Catalog LUB 
Extension record 


. Write the updated catalog record from the 













PUB buffer into the catalog. identifier ext free 
shows catalog 
free record record 


+ VSAM 
catalog 


VSAM record 










Catalog control 
record 





Updated 
catalog records 













Free catalog 
record 






CCACD1 


oe RS we >[Return code _| code 


Return 
Notes for Diagram DL 5 Description Module _—_ Procedure 
Description Module — Procedure If a variable-length field within a group 
urrence spans several physical records, 
21. The GOP's inactive flag is set on, IGGOCLAV IGGPDEL2 sala Sanaon (Geb mnicbs 
thereby deactivating it. The GOP’s type deleted. 
code and sequence number fields are 
unchanged. The displacement field is Note: If the catalog is recoverable, the 
serio 0. call to IGGOCLEG will result in a CRA 
: : update unless bit GCARPUT (‘update 
22. If an extension record contains only IGGOCLAV IGGPDEL2 inhibit”) is set to ‘1’. This bit is set in 
deleted rae the record is reclaimed by the calling procedures, which decide 
CM as a free control interval. whether CRA updating is necessary for 
iven operation. 
23-25. The CCR contains the count of free IGGOCLAV IGGPDEL2 sae 


control intervals available to the catalog !GGOCLAX !IGGPDGO 
and the control interval number of the IGGOCLAV IGGPDEL2 
first free control interval. All free control |GGOCLBA IGGPGREC 
intervals are chained together. When a IGGOCLAV IGGPDEL2 
control interval is added to the free con- I|GGOCLAW IGGPPREC 
trol interval chain, CM puts the CCR’s IGGOCLAV IGGPDEL2 
free control interval number into the IGGOCLEG IGGPPDE 
new free control interval and puts the IGGOCLAV IGGPDEL2 
new free control interval’s control- IGGOCLAX iGGPDGOP 
interval number into the CCR. The CCR’s 

free control-interval count is increased 

by 1. 
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Diagram DM1. Release Extents 







R11 CCA 


{ Buffer2 
€ CCAALPTR 


RUSWKA 


3. Retrieve the extent descriptor. RUSVOLSR 
om RUSHARBA 
RUSRLEXT 


4. Is the low RBA (DDDD) less than the input 
RBA? 


Yes No m9’) Volume record 


Group occurrence 


5. x. the high allocated RBA. 
6. Loop to process next extent field. ; G) 
7. Read the volume record. 


Data or Index catalog record 


* Diagrams BA, GA 


R11 

Do steps 1 to 16 for each volume group occurrence. 
1. Locate the volume group occurrence. 
+Buffer 2 


CTGPL 















2. Save the volume serial number. 





Data or Index catalog record 





Do steps 4 to 10 for each extent field in the volume 
group occurrence. 





Volume group occurrence 


VOLSER 





Extent descriptors 


8. Add up the released space and the number 
of extents released. 


9. Call the bit mask handler to update the =>) 


volume record bit map. 


Volume group occurrence 


Extent descriptors 


! 









Delete the extent field. 


Volume record 
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Diagram DM2. Release Extents 





Data or Index catalog record > 11. Are all extent fields in this group occurrence Data or Index catalog record 
now deleted? 


Volume group occurrence Yes No a> (12) Volume group occurrence 


4 
12. Set the group occurrence to indicate =>) 
i a apediee 
See Diagram DL, Modify a Catalog Record 


Field’s Value. 


RUSWKA 
naa ide Saket Riana REN. —>-) 
Set extents not preformatted. 





14. Is thisa NOALLOCATE data set? 
No Yes 





bf Zero the high used RBA 
and high allocated RBA. 


> (17) 


16. Set the high used and high allocated RBAs. 


See Diagram DL, Modify a Catalog Record 


Field’s Value. 
Data or Index catalog record 





Volume group occurrence RUSWKA 


17, Extract the high allocated RBA for the 
entire component. > 
HARBA . 
18 


Compute and store the released space. 





RUSHART 
RUSRLSPT 
RUSRLTEX 













19. Compute and store the number of released 
extents. 


20. Modify the appropriate fields in the data 


or index catalog record. 


See Diagram DL, Modify a Catalog Record 
Field’s Value. 


Return 
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Diagram EAI. Catalog Management Services Contents 







2.90 










DEFINE: 
Create a VSAM 
catalog or 
cluster 


See Diagram 
EC 





DEFINE 
Cluster: 
Create a 
cluster 


See Diagram 
ED 


DEFINE 
Catalog: 
Create a VSAM 
catalog 














DEFINE 
Non VSAM: 
Define a non 


VSAM 
data set in a 
VSAM catalog 


See Diagram 
EF 


DEFINE 
Space: 
Initialize 

a VSAM data 
space 


See Diagram 
EG 











Build CRA: 
Initialize a 
catalog 
recovery 
area 







Catalog 


management 


services 


overview 





See Diagram 
EB : 


DEFINE: 
AIX 
Create an 
alternate 
index 


See Diagram 
El 





DEFINE 
PATH: 

Define a VSAM 
path 


See Diagram 
EJ 


SHOWCAT: 
Display 


catalog 
information 





ALTER: DELETE: DELETE: 

Modify a Remove a VSAM AIX 

catalog record or non- VSAM Release a VSAM 
data set alternate index 


See Diagram See Diagram See Diagram 
EK EM EP 





LISTCAT: DELETE DELETE 
Retrieve a Space: Release PATH 
catalog record's all of the empty Release a 
contents VSAM data VSAM path 
space ona 
volume 


See Diagram See Diagram See Diagram 
EL EN EP 










Modify 
upgrade 
set 


DELETE 
Catalog: 
Release a 


VSAM catalog 





See Diagram — See Diagram _ | See Diagram See Diagram See Diagram 
EE EH ES ER EO 
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Diagram EB1. Catalog Management Services Overview 














Catalog management 
buffer 





Catalog record 


command. 
t Buffer 


CTGPL 


FP 1. Check the caller's authorization to issue the 
| See Diagram DD, Check the Password. 


2. Did the caller issue a DEFINE command? 








- - 
oi Yes No een 
—_ 
Leo 
> La 
ay ~ 
Sea Se Create a VSAM Catalog 
— sy 
“®™! 3. Does the caller want to create the VSAM master 
or a user catalog? 
CTGFVs 








Yes No 


>) 






Data needed 
to Create a 
catalog or 
initialize a 


data space 4. Build the VSAM catalog. 





See Diagram EC, DEFINE: Create a VSAM 
Catalog or Cluster. 






. Is the catalog recoverable? 


mE Return 


. Build a catalog recovery area. 








Yes No 












See Diagram EH, Build CRA. 


E> Return 





Notes for Diagram EB1 


2. When using the DEFINE command 
with DEDICATE ORIGIN or default 
ORIGIN, module IGGOCLFD Dedicated 
VSAM Volume is called. 
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——_—_——_> 


VSAM-owned 
direct-access volume 







ata space 


VSAM 
catalog 


Free space 
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Diagram EB2. Catalog Management Services Overview 
















VSAM catalog 
Updated volume 
VSAM-owned record that 


direct-access describes the 
volume new VSAM 


ae data space 
Initialized 
N data space 4 












CTGPL Create a VSAM data space 


Request ee ee ae ee 7. Does the caller want to create a VSAM data 
te space? 


Yes No A >(17) 


j | 8. Create a VSAM data space. 


See Diagram EG, DEFINE Space: Initialize 
a VSAM Data Space. 




























[| CTGFVs 


Data needed 
to create a 
catalog or 
initialize 

a data space 












Is the catalog recoverable? 
rt NC retin 


Build a catalog recovery area. 
See Diagram EH. Build CRA. 


reas Return 





















Create a data set 


Identifies 
the VSAM 
catalog 


SS Se ee “=>, 11. Search the VSAM catalog specified in the 
caller's CTGPL to ensure that the new data 
set’s DSNAME doesn’t duplicate an existing 
DSNAME. 


See Diagram DC1, Search: Retrieve a catalog 
record. 


Did the search routine set the no-record- 
found error code? 
CCACD1 


Yes No COE = Return Error code] 
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Diagram EB3. Catalog Management Services Overview 









Create a data set (continued) 





. Process the DEFINE command to create: 
1.° Accluster (a VSAM data set, with or without 
an index). 


See Diagram EC1, DEFINE: Create a VSAM 
Catalog or Cluster. 






CTGPL 


Request 
type 






@e AnonVSAM data set. 


See Diagram EF1, DEFINE nonVSAM: Define 
a nonVSAM Data set in a VSAM Catalog. 






CTGFVs 













Data needed 







to create a 
TCTGFV catalog or 
data set 







e An alternate index (a VSAM KSDS with or 
without an upgrade set). 


See Diagram El, DEFINE AIX. 


CTGCAT 


Identifies 
the VSAM 
catalog 











e A path (an access to a base data set plus an 
AIX, or an alternate access to a base data 
set). 


See Diagram EJ, DEFINE Path. 
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Diagram EB4. Catalog Management Services Overview 


R11 









Process an ALTER, DELETE, or LISTCAT 


. Search the VSAM catalog specified in the 
N caller's CTGPL, and retrieve the catalog record 
\ yt / identified by the caller-supplied DSNAME. 


/ Sée Diagram DC1, Search: Retrieve a Catalog 
N / Record, 








CCA 


CTGPL 















» 15. Process the command to: 


@ Modify a catalog record. 
See Diagram EK, ALTER: Modify a Catalog 
Record. 










Identifies 
the catalog 
that contains 
the record 

to be listed, 
altered, or 
deleted. 


















@ Delete a cluster or nonVSAM data set. 
See Diagram EM, DELETE: Remove a catalog 
record. 





@ Delete all empty data spaces on a volume. 
See Diagram EN, DELETE Space: Release all 
Empty Data Spaces on a Direct-access Volume. 












CTGFVs ® Delete a VSAM catalog. 


See Diagram EO, DELETE Catalog: Release a 
VSAM Catalog. 



















Data needed 
to alter or 
delete 
catalog 
information 











© Delete a VSAM alternate index. 
See Diagram EP, DELETE AIX. 












Delete a VSAM path. 
See Diagram EP, DELETE Path. 







Catalog management buffer 






© Retrieve information from a catalog. 
See Diagram EL, LISTCAT: List the catalog 
contents. 









Ratalog record to be listed, altered, or 
delete 








CCACD1 


——— [ren cose] 
Return 
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Diagram EC1. DEFINE: Create a VSAM Catalog or Cluster 





















Request 
type 
t CTGFV 





CTGFVs 


CTGFLs 





See ‘Data 
Areas" for a 





or catalog 


Notes for Diagram EC1 














Ri1 

CCA og 1. Verify that, if the VSAM master catalog exists, 
ae this request does not attempt to create another 

i | one. 
a 
gs a 
a lear 2. Verify that each of the caller’s CTGFVs: 
CTGPL = ” 
i e@ Is within the caller-program’s partition, and 


® Contains all the information needed to build Creation data CTGFL 


the catalog or cluster. Creticnmate 


. Determine the creation date. 
. Verify that each of the caller’s CTGFLs: 
ts within the caller-program’s partition, and 


Contains all the information needed to build 
the catalog or cluster. 


Newly-created 


Did the caller issue a DEFINE catalog request? 


6. Build the VSAM catalog. Je 


See Diagram EE, DEFINE | CCACD1 


Catalog: Create a VSAM Catalog. 
E> Return 


list of the 

FVTs needed . 

is Ghoata 7. Build the VSAM cluster. 

VSAM cluster See Diagram ED, DEFINE Cluster: Createa 2 -> 


VSAM Cluster. 


CCACD1 


Return 


VSAM catalog 


Newly-created 
VSAM cluster 


When the user issues the Access Method Services DEFINE command to Description Module Procedure 
create a catalog or a cluster, the CMS DEFINE initial processing routine 
insures that the caller has provided all the information necessary to create 4. ee sree ae sali) nies or IGGOCLAL ees 
a catalog or acluster. The field CCACD1 is checked for error codes. If he bid in ie CTGEL pea Mra i IGGPDEF 
no errors are found, CCACD1 will be 0. See the module prologue for mee . 
IGGOCLAL for specific error conditions. IGGPDSPE 
er Space parameter CTGFLs |GGPDBSF 
Description Module = Procedure Buffer-size CTGFLs IGGOCLBX IGGPDALR 
1. Only one master catalog is permitted. An IGGOCLAL IGGPDEF Average-record size CTGFLs 
attempt to define a second master catalog 6 IGGOCLAN IGGPDSCB 
will result in an error. IGGOCLAP IGGPDCDA 
2. CTGFVs and CTGFLs are checked by 
: : : 7. IGGOCLAN !GGPDCSB 
internal procedures in IGGOCLAL: IGGPDRDA 
Cluster CTGFV IGGOCLAL 1GGPDCWC IGGPDSCB 
Caller’s work area IGGPDCWC IGGOCLAS IGGPDEFC 
Data CTGFV structure IGGPDFSC IGGOCLAN IGGPDSCB 
Index CTGFV structure |GGPDFSC IGGOCLAJ IGGPDBDI 
Data DSNAME CTGPL IGGPDDNP 
Index DSNAME CTGPL IGGPDDNP If a volume list must be generated, {GGOCLFB IGGPGVL 
Data space CTGFV IGGPDBVC call |GGOCLFB. The CTGF Ls are IGGOCLAN IGGPDSCB 
Catalog space CTGPL IGGOCLAL IGGPDCSF then checked and completed by 
Key range CTGPL IGGPDRPG IGGOCLAN. 
File CTGFV {GGPDEF 
3. Get the current date from COMREG and IGGOCLAL IGGPDEDE 
insert it in the creation date in the CTGFL. IGGOCLEG IGGPGET 
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Diagram ED1. DEFINE Cluster: Create a VSAM Cluster 





Rai 1. Build the cluster’s AMDSB group 
occurrence. 


2. Compute the amount of direct-access 













cluster. 


+ Buffer 


header fields. 


catalog record. 





occurrence, if required. 


Describes data 
set and index 









© 


Do steps 9 through 23 to: 


ore 


Describes the 
password lj 


$ 


fields. 


Catalog management buffers 


Free catalog record # 
Free catalog record #2 
Free catalog record #3 ; 


2 
26 


Notes for Diagram ED1 


Description Module Procedure 


1. The AMDSB contains the cluster’s 
statistics and fixed characteristics. Each 
time the cluster is opened, the AMDSB 
is retrieved from the data catalog record. 
When the cluster is closed, the AMDSB 
is updated and rewritten into the data 
catalog record. 


{GGOCLAN IGGPDSCB 
IGGPDRDA 


IGGOCLBX IGGPDSPC 
IGGPDDCE 


2. The field vector table (CTGFV) con- 
tains addresses of buffer-size and record- 
length field parameter lists (CTGF Ls). 
This data is used to determine the data 
set's control-interval and control-area 
size. If the data set is key-sequenced, 
other buffer-size and record-length 
CTGF Ls determine the index’s control- 
interval and control-area size. If the 
key-sequenced data set is divided into 
key ranges, the size of each key range 
is determined. If no errors are detected, 
then control is returned to |IGGOCLAN. 


IKQVDTPE 

IGGOCLBX IGGPDDCE 
IGGOCLEG IGGPGET 
IGGOCLAN !GGPDRDA 
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CCA space required for the cluster. 
CTGPL \ 
1 cCatslag’s ale ap 3. Obtain contiguous free catalog records 
ACB ana from the catalog and assign them to the 


Build the cluster catalog record 


4. Initialize the cluster catalog record's 
> 5. Build an association group occurrence to 


lf point to the data catalog record and, if 
4 the cluster is key-sequenced, the index 


) 6. Build the cluster’s password group 


| 7. Compute the cluster catalog record’s size. 


— a» 8. Obtain 512 bytes of main storage and 
save the cluster catalog record. 


9. Initialize the catalog record’s header 











Catalog management work area 


AMDSB group 
occurrence 


Amount of space 
needed for the cluster 





Catalog management 
buffers 


Cluster catalog record 
Data catalog record 





a 


Index catalog record 


1a GETVIS Area 


Cluster catalog record 








‘Be e Build the data catalog record to describe the 
data set and its assigned space. 


> e If the cluster is key-sequenced, build the 
index catalog to describe the data set’s index 
and its assigned space. 


==) 


Description Module Procedure 


IGGOCLBY is called to perform space IGGOCLBY IGGPDRSP 
parameter calculations. 

A user’s data set is described by a IGGOCLAN IGGPDCCE 
cluster catalog record, a data catalog 

record, and, if the data set is key- 

sequenced, an index catalog record. 


IGGOCLAG is called to get control- 
interval numbers assigned. 


IGGOCLAG IGGPAOCI 


For recoverable catalogs, the CRA 1GGOCLAN 1IGGPDCCE 
volume has to be known. The cluster 
record is therefore saved until this 


volume is known. 
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Diagram ED2. DEFINE Cluster: Create a VSAM Cluster 


Obtain direct-access space to satisfy the data 


set's or index’s space allocation requirements 


R11 Cr > 10. Can the data set or index share its space with 
other VSAM data sets and indexes? 


CCA 
TGPL 





















Yes No (Unique data set) 


11. Allocate a VSAM data space 
to the data set or index. 


See Diagram EG, DEFINE 


Space: Initialize a VSAM Data VSAM-owned 
(2) Space direct-access 
: volume 


CTGFLs 


(a= >12. ls NOALLOCATION specified? 
Space allowed 
| | No Yes => to the data set 
¥ or index 
Cia, Allocate space to the data set or index 


Describes data 
set and index 
space 
requirements 














Work eres from an existing VSAM data space. 
See Diagram DJ, Suballocate: Obtain R11 
; Additional Space from a Nonunique VSAM 
Low.and high 


Data Space. 


CCHH values for : ; ; 
each extent > 14, Build an extent descriptor that describes at : 







CCA 








allocated to the extent allocated to the data set or index. 


data set, index, <V 
15. If the data set is divided into key ranges, 


or data set's 

key range . 
assign space to each of the data set’s key 
ranges. 


O16. Assign candidate volumes to the data set or 


index, if required. 






Work area 






Extent 
descriptors 


CTGFLs 





See Diagram DJ, Suballocate: Assign a 
candidate volume to the object. 






ex’ 


Describe data set 
and index 

volume usage and 
serial numbers 


CTGFLs ] 






Notes for Diagram ED2 


Description Module Procedure Description Module Procedure 

10. IGGOCLAN 1GGPDSCB 15. Each key range is assigned physical |GGOCLAJ IGGPDSPO 

IGGOCLAJ I{GGPDBDI space and space allocation contin- 
|IGGPDSPO ues for each range. 

11. A data space entry is added to the !GGOCLAJ |GGPDSPO 16. Acandidate volume is available to IGGOCLAJ 1GGPDCNV 
volume catalog record, and the IGGOCLAQ IGGPDEFS contain part of the cluster if more IGGOCLAR IGGPSALL 
data set’s name is added to the space is needed later. None of the IGGOCLAJ IGGPDBDI 
volume catalog record's data candidate volume’s space is allo- !GGOCLAK 1GGPDCMB 
set directory. cated to the data set or index when 

the cluster is created. 

13. The data set’s name is added to IGGOCLAJ |IGGPDSPO 

the volume catalog record’s data IGGOCLAR IGGPSALL 


set directory, and the volume 
catalog record's data space entry 
is updated to show the cylinders 
and tracks allocated to the new 
data set or index. 


14. IGGOCLAJ IGGPDSEX 
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Diagram ED3. DEFINE Cluster: Create a VSAM Cluster 






Build a volume information group occurrence 
to describe 


16. Is NOALLOCATION specified? 
No Yes 













17. Each of the data set’s or index's 


R11 . 
toca candidate volume. 
Work area 
Be > (23) 


Extent 
t Buffers 


descriptors 
tcoTGPL 
19. All extents allocated to each of the data 


set’s key ranges on each volume, if 
oS required. 


20, Each of the data set’s or index’s candidate 
ee volumes, if required. 









T——— > 18. All extents allocated to the data set or 
index on each volume. 





Volume information 
roup occurrence 






















Describe data set 
land index volume 
usage and serial 

numbers 















No Yes 






Tt CTGFLs 


r= 21. Is the “sequence set with data” option specified? 
I 
| 
| 


CTGFLs 
22. Assign part of each of the data 


Pescr be cataet set's extents to the sequence set. 


land index 


characteristics [ 
Catalog management buffers 
Data catalog record 


[eg ee 
Index catalog record 


. Write the cluster catalog record into the catalog. 


occurrence into the data set or index 
catalog record. 


See Diagram DL, Modify the Catalog Record. 


25. Write the data or index catalog record into 
the catalog. 


26. Free the main storage of the work areas 
obtained by the Define routine. 


CCACD1 
Return 
Notes for Diagram ED3 Description 
Description ‘Module Procedure set records. The low and high CCHH values 
16. If NOALLOCATION data set construct. | 1GGOCLAK IGGPDCMB in the index record’s volume information 
rs inf . IGGPDBCV group occurrence are those of the extent 
te volume CUTBHOM dba sepemiaiacd obtained for the data set. The low and high 
for all the candidate volumes of the data RBA values are for the sequence set and are 
set. relative to the index addresses. 


18. Each volume that contains a part of the datalGGOCLAK !GGPDBVO 23 
set or index is described by a volume infor- 
mation group occurrence within the data or 


index catalog record. Note: If the catalog is recoverable, the call 


ae : to |GGOCLEG will result in a CRA update 
9, 
19. If the data set is divided into key ranges, IGGOCLAK IGGPDRNG unless bit CCARPUT (“update inhibit”) is 
each key range’s space on a volume is 


described in a separate volume information nee rie ss : See alate 
/ cedures, which decide whether CRA updat- 
group occurrence. If the key range’s space 


: ing is necessary for a given operation. 
is on more than one volume, each volume a x : ’ 


that contains part of the key range’s space 24. The modify routine (IGGOCLAYV) inserts 


is described in a separate volume informa- P . 
: each volume information group occurrence 
tion group occurrence. : 
into the record. 


. The module calls the clear buffer routine 
to write the cluster record into the catalog. 


20. Construct the volume information group IGGOCLAK IGGPDBCV 25 
occurrence for all candidate volumes of 
the data set. 


. ACM routine writes the completed data 
or index catalog record into the VSAM 


22. If the “sequence set with data” (IMBED) | I1GGOCLAK IGGPDSSP the record. 
option is specified, part of the data set's 26 


: ; . Free all unneeded storage resources. 
space is allocated to the index for sequence- 
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| 
24, Put each volume information group SS 


catalog and frees the CM buffer that contains 


Work area 








Volume information 
group occurrence 





VSAM catalog 
identified by the 
caller’s CTGPL 


Catalog management buffers 


New cluster 
catalog record 













Updated index catalog record 


Updated data catalog record 


VSAM catalog 
identified by the 
caller’s CTGPL 


Module 


1GGOCLAK 
IGGOCLCB 
IGGOCLEG 


IGGOCLCY 
IGGOCLAV 


IGGOCLCY 


IGGOCLCY 
IGGOCLAV 


IGGOCLA8 


New data 
catalog record 


New index 
catalog record 


















Procedure 


IGGPDBCV 
IGGPCLBF 
I{GGPPAD 


IGGPDMOP 
IGGPMOD 


IGGPDMOP 


|GGPDMOP 
iGGPMOD 


IGGPDFRS 
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Diagram EE1. DEFINE Catalog: Create a VSAM Catalog 
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= 


1 
CCA 


CCA 
CTGPL 







Buffer CTGFLs 
Describe catalog ol 
CTGPL space requirements 
Request 
type 


CTGFV 


CTGFVs 
CTGFLs 


CTGFLs 


Describe the 
catalog’s data set 
and index 
characteristics 
















Build the catalog’s cluster record (C1 #2) 
4, 


5. Build an association group occurrence to 


6. Build the catalog’s password group occurrence, 


Ri1 CCA 


[ * Workarea | area 


Catalog management 
work area 


AMDSB group 
occurrence 













Build the catalog’s AMDSB. 








Amount of space 
needed for the 
catalog 





Compute the amount of direct-access 
space required for the catalog. 







If this is a user catalog, set a user catalog 
entry in the master catalog. 










Catalog cluster’s 
record size 








Initialize the cluster record’s header fields. 





point to the catalog’s data catalog record 
(C1 #0) and index catalog record (Cl #1). 





Master 
catalog 












if required. 


7. Compute the cluster record’s size. 


CTGFLs 


Describe catalog’s 


Passwords 





Catalog management buffers 


Catalog’s cluster 


Notes for Diagram EE1 


Description Module 


j. The AMDSB contains the catalog’s IGGOCLAP 
statistics and fixed characteristics. 

Each time the catalog is opened, the IKOVDTPE 
AMDSSB is retrieved from the cata- 

log’s data catalog record (Cl #0). 

When the catalog is closed, the 

AMDSSB is updated and rewritten 

into the data catalog record. 


2. The field vector table (CTGFV) con- IGGOCLAP 
tains addresses of buffer-size and 
record-length CTGFLs. This data 
is used to determine the catalog’s 
control-interval and control-area 
size, and the amount of space 
required for the catalog. 


3. User catalogs are internally identi- 
cal to master catalogs. The only 
difference is that the master cata- 
log contains an entry pointing to 
the user catalog. 
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(8) 


Procedure Description Module Procedure 
IGGPDCDA 5. The cluster catalog contains an IGGOCLAN IGGPDCCE 
1GGPDCVS associated data set group occur- 

rence to locate the catalog's data 

catalog record (CI #0) and an 

associated index group occurrence 

to locate the catalog’s index cata- 

log record (CI #1). 
|GGPDCSP 
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Diagram EE2. DEFINE Catalog: Create a VSAM Catalog 


C 





Extent descriptors 
(from step 8) Y> (8 ) 


Volume informa- | 
tion group 


—— — > 15 
occurrence (from | 
step 10) | | 
Catalog management buffers L — —> 16 





Catalog’s 
self describing 


catalog records 


Ci ffo Volume catalog record 


Ct #H10 


13 


Space map group occurrence 
for the volume 


Notes for Diagram EE2 


10. 


2,100 


Description 


The VSAM catalog is always built 
in a data space that can contain 
other VSAM data sets and indexes. 
A new data space is allocated to the 
VSAM routine, and the data space 
is assigned to the new data set. 


A data set directory entry contain- 
ing the data set’s DSNAME is added 
to the volume catalog record. 


The catalog might contain records 
that describe the user’s VSAM 

data sets, the user’s nonVSAM 

data sets, and direct-access volumes. 


17 


Module 


IGGOCLAS 
IGGOCLAQ 


IGGOCLAS 
IGGOCLAR 


IGGOCLES 


IGGOCLES 


See ‘Data Areas” for details about 
the first ten records in the catalog. 
These records define the catalog as 
a key-sequenced VSAM data set, 


IGGOCLAS 


IGGOCLAV 


VSE/VSAM VSAM Logic, Volume | 


. Build a volume information group =) 
occurrence to describe each part’s i 
assigned space (from step 9). 

_ Build the catalog records that describe a Gy) 





CaP 8. 
CA | | 
ACB (from | Cy 
step 13) | 9 
Describes : 
CCA theratalog 7 On 
RPL (from {| | “\ oe 
sei) | |_| 
Describes the | | 
PUT request || | 
1 tt 
t Buffer | | | ond 
|, | 
i! | 
CTGPL | | * 
I | 
| = — > 13 
CTGFV CTGFL | l 
Catalog volume’s | 
serial number l | 
I 
Work area | 
| 


Initialize a VSAM data space. 


See Diagram EG, DEFINE Space: Initiali 
a VSAM Data Space. 


=e) 


ze | 





Assign part of the catalog’s space to each 
part of the catalog. 


Catalog management 
work area 












key ranges. 





Low and high CCHH 
values for each extent 
allocated to the data 

space 


catalog as a key-sequenced data set with two | 


Build the control blocks to allow the 
catalog to be opened and processed as a 
VSAM data set. 






Extent descriptors for 
each extent allocated 
to the catalog 


Volume information 
group occurrence 


Open the catalog’s ACB to allow catalog 
records to be written. 






See Diagram BA, Open: Connect a User's 
Program to a VSAM Data Set. 





Write the catalog’s self-describing records 
(built in step 11) into the catalog. | 


VSAM-owned 
direct-access volume 


Build and write true-name catalog 
records for the catalog DSNAME and the 
data space’s volume serial number. 


Close the catalog’s ACB. 


See Diagram GA, CLOSE: Disconnect a 
User’s Program from a VSAM Data Set. 


range data 


Delete the control blocks built in step 12. 





Records avail- 
able to describe 
VSAM clusters, 
volumes, and 
nonVSAM 

data sets 


self- 
describing 
records 





Procedure Description Module Procedure 
IGGPDCSP describe the space allocated to the 
IGGPDEFS catalog’s data records, index records, 
and true-name records, describe the 
free space within the catalog, and 
describe the allocated tracks on the 
catalog volume. 
IGGPDCSP 12, 1GGOCLAE |GGPDCOC 
IGGPSALL 1GGPDCCB 
13. $$BOPEN 
IGGPDCLD 
14. IGGOCLAE IGGPDCOC 
IGGPDCPR 
IGGOCLCG IGGPXIO 
IGGPDCVO 15. IGGOCLAE —_IGGPDCOC 
IGGPDCBE 16. $$BCLOSE 
IGGPDCEB 
IGGPDCME . 17, IGGOCLAE IGGPDCOC 
IGGPMOD 
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Diagram EE3. DEFINE Catalog: Create a VSAM Catalog 






R11 


Open the VSAM catalog 







18. Did the request create the VSAM master 
catalog or a recoverable user catalog? 
















CTGPL CAXWA 










- mo No Yes 








CTGPL ge COMREG 
aes -7 19. Build the control blocks 
eg uesUtyDe required to open the VSAM 
catalog. 
AMCBS 
20. Open the VSAM catalog. : 
ANCHT 
See Diagram BA, Open: Con- 
nect a User’s Program to a 
VSAM Data Set. 
Opened VSAM 
catalog 
CCACD1 
Return 
Notes for Diagram EE3 
Description Module Procedure 
19. IGGOCLAD IGGPMCO2 
20, |GGPDCOC 
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Diagram EF1. DEFINE NonVSAM: Define a NonVSAM Data Set in a 
VSAM Catalog 


Ru 













atalog’s 
DSNAME 


CTGFV 


Build a nonVSAM data catalog record 












Catalog management buffer 
NonVSAM catalog record 










1. Build the nonVSAM catalog record and 
write it into the catalog. 



















Device type, serial 
number, and file 






Data 




















set's sequence number of 
CTGFLs : i - record an =>) each of the non- 
ere 2. Build a true-name catalog record and DSNAME.” >| Cacho! Hie nan: 






write it into the catalog. 


3. Update the catalog’s index records so that 
the nonVSAM catalog record can be 
located by the nonVSAM data set’s 
DSNAME. 





DSNAME volumes. 








Data set's 
volume serial 
number list 









Pointers to 
CTGFLs that 
define a non- 
VSAM data 



























Data RBA of 
set’s true-name 










































set Device DSNAME _ record 
types 
VSAM catalog 
File Dat Control interval 
sequence Index Satie number of the 
numbers nonVSAM 
record DSNAME catalog record 
VSAM catalog True-name 
record 
ee cece NonVSAM 
Catalog’s record 
index 
records 
Free 


catalog 
ecord 


(Identified 





CCACD1 


by the caller’s 
CTGPL) Return 


Notes for Diagram EF 1 


Description Module Procedure 


1, The define nonVSAM routine trans) IGGOCLBH IGGPDEFA 
fers the nonVSAM catalog record IGGPDAIN 
from a CM buffer in storage to the 
VSAM catalog specified by the 
caller's DEFINE command. 


Control interval numbers are assigned IGGOCLBH !GGPDAIN 


for the nonVSAM data set. IGGOCLAG IGGPAOCI 

The 8-character device name iscon- 'tGGOCLBH IGGPDAIN 

verted into a 4-character device IGGPDANL 
code, using the device name table. IKQDNT 


IGGOCLAV is called to add volume IGGOCLBH IGGPDAVO 
occurrences, IGGOCLAV IGGPMOD 


If an error occurs during the define IGGOCLBH IGGPDAVO 
process, |IGGOCLAN is called to back I|GGOCLAN IGGPDEFA 
out any Cl numbers assigned and any 

entries put into the VSAM catalog. 
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Diagram EG1. DEFINE Space: Initialize a VSAM Data Space 












Catalog’s 
DSNAME |\ 
if CTGFV 
1. 


CTGFV 


(For VSAM 
data space 
initialization) 
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/ 
y 
/ 


@) 


2. 


“SZ 






Data space 
allocation 
requirement 


~ 






/ 
CTGFL / 
Volume 
serial 
number 





Volume 
catalog 
record 









VSAM catalog 





Volume catalog 
record 


VSAM user's 


data volume 
F4 label 





Notes for Diagram EG1 











6) 
N 
4 






*Diagrams EB, ED, EE 


Confirm that the required volume is 
mounted. 


Console 


Message to 
operator 


"“4255A Wrong pack, 
mount nnnnnn” 


Initialize the volume catalog record 


Does the VSAM catalog contain a volume 
catalog record for the new data space’s 
volume? 


N 
Yes : 


3. Is the volume already owned by 


- Update the volume’s format 4 
VTOC label to show that the 
volume is now owned by the 
VSAM catalog. B 

5. Build the volume catalog 
record, 





Description 


— 5. See “Data Areas” for details about the 
Description Module Procedure volume catalog record. 
1. IGGOCLAQ IGGPDEFS 6. The volume catalog record is identified 
IGGOCLA6§ IGGPVMTV by the volume’s serial number. 
IKOASNMT 
IKOVTCOO 
2. If avolume catalog record exists for the 
volume and if the volume already contains 
a VSAM data space, a data space group 
occurrence is added to the volume catalog 
record to describe the new VSAM data 
space. 
3. If this volume is already owned by VSAM, IGGOCLA6 IGGPF4PR 
error code decimal 148 is issued. 
4. If the volume is a candidate volume (one IGGOCLAQ IGGPDEFS 
that is eligible to contain a VSAM data IGGOCLA6 IGGPF4PR 
space, but doesn’t as yet), the volume’s IGGOCLBU IGGPF4RD 
format-4 VTOC label! is updated to show IGGPF4DQ0 
that the VSAM catalog is now the volume IGGPF4WR 


owner. 
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Volume catalog 





VSAM? 
No Yes VSAM user's data 
(Try another volume 
volume) ae 
F4 label 


data space 


uffer 






record 


CCA 







Low/high CCHH 
values for the 
allocated 
data space 


Module Procedure 
IGGOCLA6 _IGGPIVER | 
IGGOCLAQ IGGPDEFS 
IKOVDTPE 
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Diagram EG2. DEFINE Space: Initialize a VSAM Data Space 


Build a VTOC entry for the data space 































R11 
CCA > Build a format-1 label to describe the VSAM 
CCA Pi data space as a VSE data set's space. 
-_ 
—_ 
oo 9, Is this an implicit DEFINE SPACE for a 
Low/highCCHH wae A UNIQUE data set? 
values for the -|~ 1 , 
allocated = >(c) / No Yes 
data space / 
/ 10. Put the data set’s DSNAME in Buffer 
/ the format-1 label. Volume catalog record 
Data space entry Data set directory entry 
| 
Describes the tData | DSNAME of the 
/) 41. Write the format-1 label into the volume’s available space set's | data set that 
/ in the new space | resides in the 
/ VTOC. VSAM data entry | data space 
CTGPL 
_— * CTGFV / See Diagrams FB and FF, Allocate data 
/ spaces and read VTOC label. 
/ 
/ 
/ 
/ 





Write the volume catalog record into the catalog 


/ 
f ; ; ’ 
/ =m 12. Build a data space entry in the volume =) 
7] catalog record to describe the data space’s 
/ 


cylinder and track allocation. 


CTGFV CTGFL l 
Data set : : 
attributes ——— = 13. Is the data space assigned exclusively to one 
data set? VSAM user’s data 


volume 
















entry in the volume catalog 
record to describe the data 
set’s use of the data space. 


(For VSAM 
data space No Yes G 
initialization) z VSAM 
CTGFL catalog 
a Build a data set directory 
DSNAME | ane 


Buffer 


I 15. Write the volume catalog record into the 
Volume catalog record ee ee 


catalog. 
Se ony 


Return 
Notes for Diagram EG2 Description Module Procedure 
Description Module Procedure Note: If the catalog is recoverable, the call 
to {GGOCLEG will result in a CRA update 
10. A VSAM data space assigned exclusively IGGOCLAQ IGGPDEFS unless bit CCARPUT (the ‘update inhibit” 
to one data set is described by a format-1 bit) is set to ‘1’. This bit is set in the 
label that contains the data set’s DSNAME. calling procedures, which decide whether 
if a data space can be assigned to more than CRA updating is necessary for a given 
one data set, its format-1 label contains operation. 
a DSNAME generated by the define space 
routine, 12. See “Data Areas” for details about the data IGGOCLA6 !GGPDFS2 
space entry. IGGPCSHG 
11. Prior to calling IKQALLOO, IGGOCLAOQ IGGOCLEG IGGPPAD ‘ IGGPCSDG 
sets the address of the DADSM exit routine, IGGOCLAQ !GGPDEFS IGGPDSMD 
IKQDXT (located in IGGOCLAQ), into the IKQALLOO IGGOCLAV iGGPMOD 
DADSM parameter list. This routine is IGGOCLAQ !GGPDEFS ; 
called by DADSM during space allocation IGGOCLA6 !GGPCOBT 14. The volume catalog record contains the IGGOCLA6 IGGPCDSD 
to place the Access Method Services- IKQVTCOO identifier of each data set that resides in 
specified secondary space quantity and an IGGOCLA6 IGGPCOBT part or full on the volume. 
expiration date into those fields of the IKQRDSOO 
format-1 label before it is written into the IGGOCLA6 !GGPCOBT 
VTOC. The secondary space quantity is ([KOASNMT 


for OS/VS compatibility only. This 
information is not used by VSE. 


EG2 
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Diagram EH1. DEFINE CRA: Create a Catalog Recovery Area 


R41 
















. Check the return code in the volume serial 


: , Volume checklist 
number list, and set the corresponding 




















CCA CTGPL : en oe ee eee 
r*cTaPL entry in the volume check list to X’FF 
aes if the return code is not zero Py olume 
Volume serial Z | checklist 


CTGFV 
Volume serial 
number list 





serial list 





Volume serial 
number list 


j an 
2. 1s the volume check list completely non zero? 


No Yes o> Return | 


3. Set up a volume serial number list in the 
work area for all volumes that are to 
| receive a CRA. 


. Was this routine invoked by a DEFINE 
CATALOG request? 


% Yes >) 


VSAM catalog 5. Obtain storage for the additional record 
areas and initialize it. 






CMS work area 


l 
V 


CMS buffer 





6. Read the data, cluster, control, (a) Anienut 
and data extension (8) i ers 
records for the catalog. B 

7. Set the unused buffer space to free records? 

8. Delete the index association group —>°) 






Catalogs self- 
describing records 


occurrence from the cluster record. | 
9. insert the catalog name into the cluster 
and data records. Kin (8 ) 


. Set up the suballocate interface, set the ‘‘no 
put” bit to inhibit writing into the CRA, and 
set the space header flag to indicate that this 





isa CRA. 





Notes for Diagram EH1 


Step Module Procedure 
1-3. IGGOCLCR IGGPCADR 
4.5. IGGOCLCR IGGPBCRA 
6. IGGOCLCR IGGPBCRA 
1GGOCLEG IGGPGET 
7. IGGOCLCR IGGPBCRA 
8, 1GGOCLCR IGGPCRDI 
"  IGGOCLAV 1GGPMOD 
9-10. IGGOCLCS IGGPCRVL 
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Diagram EH2. DEFINE CRA: Create a Catalog Recovery Area 












11. Suballocate space for the CRA. CMS buffers 
See Diagram DJ, Subatlocate. 
_ ———— 12. Insert the volume records for this volume ee eo | 
into the CMS buffers. 
| Catalog control record 
13. Modify the volume information in the fF sss 


data record. 


See Diagram DL, Modify a Catalog Record 
Field’s Value. 


14. Change the catalog control record to 
reflect the entry-sequenced structure of 


.- the CRA. | 
> 15. Read the format 4 label, insert a TT 
pointer (CKD) or physical block pointer 
(FBA) to the CRA, and rewrite the format vroe | 


4 label. 
See Diagrams FF and FG, Read and Write 


VTOC labels. CL eee 
SS” 


16. Open the CRA for processing as a VSAM data 
CMS buffers set. 


17. Insert the CRA self-describing records 
into the CRA. 


Volume serial 
number list 





18. Close the CRA. 


19. Any more volumes to be processed? 


No Yes 
Volume serial 


20. Set the return code into the volume serial number list 


number list built in step 3, and re-attach ee ee al 
this list to the CPL. 





Notes for Diagram EH2 


Step Module Procedure Step Module Procedure 
11. IGGOCLAR 'GGPSALL 19, |GGOCLCS IGGPCRVL 
12, IGGOCLCS 1GGPCRVL 20, IGGOCLCR 1GGPBCRA 
IGGOCLEG IGGPGET 
IGGOCLCS IGGPCRVL 
13, |GGOCLAS IGGPDCRC 
1GGOCLCS IGGPCRVL 
IGGOCLAV |GGPMOD 
14. IGGOCLCS IGGPCRVL 
15. IGGOCLA6 (GGPVMTV 
IGGOCLBU IGGPF4RD 
1GGOCLCS IGGPCRVL 
IGGOCLBU {GGPF4WD 
16. IGGOCLCS IGGPPRDS 
1GGOCLCO IGGPCRAO 
17, 1GGOCLCG IGGPPXIO 
IGGOCLCS IGGPPRDS 
18, $$BCLOSE ae 
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Diagram EH3. DEFINE CRA: Create a Catalog Recovery Area 





CCACD!1 


21. Free the buffer space and set the 
return code. ma Return 


Error handling 


22. Is this the catalog volume? 


Yes No 
$ CCACD1 


23. Back out the catalog. Hand back the 
volume entry (and the user catalog entry, 


if this is a user catalog). oma Return 


24. Hand back the volume entry. 


Volume serial 
number list 





. Clean up the format 4 label of this volume. 





CCACD1 


Return 


Notes for Diagram EH3 
Note: Control is passed to the error handling routine (Step 22) 


Step Module Procedure whenever an error is detected. 

21, IGGOCLCR IGGPCADR 

22. IGGOCLCR {GGPBCRA 

23. . |GGOCLCR IGGPBCRA 
IGGOCLAE IGGPDCBO 
$$BCLOSE _ 
{GGOCLCO IGGPSCAX 
$$BCLOSE oe 

24. {GGOCLCR IGGPBCRA 
tGGOCLCR IGGPCRBO 
IGGOCLEG IGGPGET 
I1GGOCLEG IGGPPDE 

25. IGGOCLBU IGGPF4RD 
IGGOCLBU IGGPF4WR 
IGGOCLAF IGGPSKSP 
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Diagram EI1. DEFINE AIX: Create an Alternate Index 


















































© Module 
R11 CTGFLs 
CCA Describes data Col 
set and index L/ Catalog management 
CCA characteristics work area 
|e : ; AMDSB group 
t Poh a Build the AlX’s AMDSB group ena aa REsahancs IGGOCLCA 
norte ~e 1 occurrence. | re ; ere 
~ ‘ t 
ae. 2. Compute the amount of direct-access sg eee eit? 
ss | space required for the AIX. 
CTGFlLs e> ~~ ~~ 
CTGPL Describes data fc) 3. Obtain contiguous free catalog records 
CTGFVs ial index | from the catalog and assign them to the 
: AIX. 
CTGFVs requirements (a ) B itd f AIX ‘ | d 
TGFLs ~~ ul e catalog recor 
sl (e ) - Initialize the AIX catalog record’s header IGGOCLAN 
| fields. Catalog management 
CTGFL (+) F, 5. Build an association group occurrence to buffers 
“7 point to the data catalog record and to the Cluster catalog record 
base cluster (a) | index catalog record. 
Bree (o> 6. A ea Password group occurrence, Index catalog record 
Describes the E70 ) a ; : 
asswords 7. Compute the cluster catalog record’s size. IGGOCLBX 
Pp ; 3 VSAM catalog IGGOCLCA 
z (e)- => 3. ie a cluster catalog record into identified by the 
| the catalog. caller’s CTGPL 
Catalog management 9. Modify base cluster record — add a G group 
buffers occurrence. 
Free catalog record #1 New cluster 
aes: Steps 10 and 23 are carried out twice, in order to: catalog record 
Free catalog record jf3 a, 
(F)-- ——» ° Build the data catalog record to describe the \GGOCLAJ 


| data set and its assigned space. 


(@ }-- “2B © Build the index catalog record to describe the 
data set’s index and its assigned space. 
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Diagram EI2. DEFINE AIX: Create an Alternate Index 
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Work area 

Low and high CCHH 
values for each ex- 
tent allocated to the 
data set, index, or 
data set’s key range 
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CTGPL 
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| 


Cy! 
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CTGFLs 
Describe data 
set and index 
volume usage 
and serial nos. 










CTGFVs 












CTGFLs 
Describes data 
set and index 


space 
requirements 


Describe data 
set and index 












17. 
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: ; | 
(r> 10. Initialize the catalog record's header fields. 
Obtain direct-access space to satisfy the data, 


set’s or index’s space allocation requirements 





oS 12. 


. Build an extent descriptor that describes 


Catalog management 
buffers 


Data catalog record 
Index catalog record 


Module 
IGGOCLAJ 


Was the AIX defined with the UNIQUE 
attribute? 


No Yes 





Allocate a VSAM data space 


to the data set or index, VSAM-owned 
direct-access 
See Diagram EG1. DEFINE volume 


Space: Initialize a VSAM Data 
Space. 


Space allocated 
to the data set 


ls noallocation specified? or index 


No Yes 


Allocate space to the data set or index 
from an existing VSAM data space. 


See Diagram DJ1. Suballocate: Obtain 
Additional Space from a Nonunique VSAM 
Data Space. 


Work area 


Work area 


each extent allocated to the data set or 
index. 


If the data set is divided into key ranges, 


Extent 
descriptors 





assign space to each of the data set’s key 
| ranges. 


Assign candidate volumes to the data set or 
index if required. 


See Diagram DJ1. Suballocate: Assign a 
candidate volume to the object. 
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Diagram EI3. DEFINE AIX: Create an Alternate Index 




























- - - Modul 
R11 Work area Build a volume information group occurrence R11 ces 
Low and hig to describe: 
CCHH values for Work area 







Alt extents allocated to the data set or index 
on each volume. 


each extent allo- 
cated to the data 
set, index, or data 
sets key range 


Extent 
descriptors 
(from steps 14&15) 


Volume informa- 
tion group occur- 
rence (from steps 
17,18, and 19) 







Volume informa- 
tion group occur- 
rence ~ 













[Tf Work area _ | 


(}Work area __| 


ITCTGPL 





























19. All extents allocated to each of the data set’s 
key ranges on each volume. 









20. Each of the data sets or index’s candidate 
volumes. 


21. Is NOALLOCATION specified? 
oy ¥ Ves E> (29) 


~-@ 22. \s the “sequence set with data’ option 
| specified? 













CTGFVs Describe data 
set and index 
volume usage 


and serial nos. 


No Yes (IMBED) 






management buffers 






Updated data catalog record 


Updated index catalog :ecord 






( YS, 23. Assign part of each of the 


data set's extents to the 
sequence set. 





CTGFLs 


Describe data 
set and index 
characteristics 


VSAM catalog 
z identified by the 
(a > 24. Put each volume information group 


(oy occurrence into the data or index catalog 


record. New AIX data 
catalog record 






caller's CTGPL 











See Diagram DL1, Modify the Catalog Record. 
apareaeg (@ > 25. Write the data or index catalog record te sve ve ord neo geae 
50) | the catalog. ore ee 


(a> 26. Free the unneeded storage of the work areas 
obtained by the Define routine. 


Data catalog record 


Index catalog record 






. Was the data component processed? 
Yes No 


(10) Return to process index. 
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Diagram EI4. DEFINE AIX: Create an Alternate Index 











CTGFL Module 
Demis la wr e —~ — ~ ~~ B>(28) |s NOALLOCATION Specified? IGGOCLCA 
and index ; 
characteristics No wes a> ReGen 

Vv IGGOCLCD 


Is this AIX to belong to the upgrade set? 


* No Gi!» Return 
Add the AIX to the upgrade set. 


See Diagram ER, Modify the Upgrade Set. 


Return 
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Diagram EJ1. DEFINE Path: Create a VSAM Path 





CTGFLs 














Association 
group 
occurrences 












Catalog management 
buffers 
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Check that the CTGF Ls provide all the 
information needed to build a path. 


Retrieve the association group occurrences 
from the base cluster or AlX catalog record. 


Check. the supplied password against the 
password of the related object, if password 
protected. 


Build the new path record and write it into 
the catalog. 


Insert a group occurrence for the path into 
the base cluster or Al X catalog record. 


Return 








Module 
or procedure 





CMS work area IGGOCLCP 


Association 


group 
occurrences 













IGGPPASE 


Catalog management 
buffers 


New path record 
Modified cluster 
or AIX record 















IGGPBAMO 
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Diagram EK1. ALTER: Modify a Catalog Record 


” S 


CTGPL R11 
Modify the catalog record’s fields 





CTGPL 







CTGFV 


Describes all 
fields 
to be modified 











Do steps 1 through 3 for each user-specified field: 





1. Locate the field’s address and length. 













Field’s 


74 See Diagram DK, Obtain a Catalog Record ecctess 
y Field's Value. fenath 
va 2. Modify special fields: 
Field name a © Change a data set's DSNAME: do steps 5-9. 


Catalog management buffer 


t Update e Assign a candidate volume: do steps 10-14. 


data 
® Delete a candidate volume: do steps 15-18. 


, Updated 
®@ Change an AIX’s attribute field 
(UPGRADE/NOUPGRADE): See Diagram ER, 


Modify the Upgrade Set. 


Catalog management buffer 
Catalog record 
3. Modify other catalog fields as specified, 


replacing the existing information with the 
updating information. 


Original 


See Diagram DL, Modify a catalog record 
field’s value. 





4. Rewrite the updated catalog record. 





CCACD1 
Return 
Notes for Diagram EK1 
Description Module Procedure 


The ALTER command enables the user to modify some of the information 
he established when he created a VSAM data set. 


2. When the data set name or allocated —  {IGGOCLBD IGGPALT 
candidate volumes are changed, other IGGOCLEG IGGPGET 
catalog records besides the data set catalog IGGOCLBD IGGPALT 
record must be updated. IGGOCLEG !IGGPPUPC 


IGGOCLBD IGGPALT 
IGGOCLBE IGGPALVL 
IGGOCLBD !IGGPALT 
1GGPALMD 
\GGOCLAV IGGPMOD 
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Diagram EK2. ALTER: 








7 


VSAM catalog 












Data set 
record 





VSAM user's 
data set 


Notes for Diagram EK2 


Description 

5. The catalog specified by the ALTER 
command's CATALOG parameter is 
examined. The new name to be added 
must not exist in the catalog. 


6. Anewentry is placed in the high key 
range portion of the catalog. 


7. Adetermination must be made as to 
whether or not the data set is unique. 


8. All volumes that contain a format-1 
label must have their names modified in 
the VTOC label. 


9. The name and control-interval number 
fields in the data set’s true-name record 
are set to 0 and the record identifier field 
of the catalog record pointed to by the true- 
name entry is set to C’F’. 


CTGPL 
: ean _—™ 5. Search the VSAM catalog to ensure that the Catalog’s 
Ulva ne -_— , @f —-newname doesn’t duplicate an existing name. index records 
TSA act aw See Diagram DC1, Search: Retrieve a Catalog 
ata se 
DSNAME 7 Record. 


“| 
Z 6. Build a new true-name catalog record, 
-_— a 


Modify a Catalog Record 









VSAM catalog 
Change a data set’s DSNAME 










True-name 
record 
write it into the VSAM catalog, and update 
the catalog’s index and CRA (if the catalog 
recor 


is recoverable). 


Z 7. Is thisa UNIQUE data set? VSAM user's 
data volume 
Old co - | No Yes 
nee oF ¥ 
oo 8. Update the data space’s == > vtoc 


format-1 label with the new 
DSNAME. 







data 


VSAM user’s space 


data set 


| 
es 


See Diagram FC, Rename Unique 
Data Set. 


9. Remove the old true-name record from the 


catalog. 


Module Procedure 
IGGOCLBD IGGPALNM 
{GGOCLEG IGGPGET 
IGGOCLBD IGGPALNM 
IGGOCLEG IGGPPAD 
IGGOCLBD IGGPALNM 
IGGOCLEG IGGPPDE 
IGGOCLBD IGGPALNM 
{KOQRENOO 
IGGOCLBD IGGPALF1 
IGGPALGV 
IGGOCLAZ IGGPEXT 
IGGOCLBD IGGPALT 
IGGOCLBE - |IGGPALVL 
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Diagram EK3. ALTER: Modify a Catalog Record 


VSAM catalog 







Data or index 
catalog record 


VSAM catalog 






Data 
record 










Volume 
record 










Volume 
record 












VSAM 
candidate 
volumes 


Notes for Diagram EK3 


Description Module 

12, IGGPALVA calls IGGPSALL 
(I1GGOCLAR) to assign the candidate 
volume to the data set. If avolume !GGOCLAZ 
catalog record does not exist for the IGGOCLBE 
candidate volume, the suballocate 


routine (IGGOCLAR) returns an {GGOCLAR 
error code. 
See Diagram DJ for details of the 
suballocate routine. 

13. The volume catalog record contains IGGOCLBE 
a data set directory that describes IGGOCLAZ 


each VSAM data set’s use of the 
volume’s VSAM space. 
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Assign candidate volumes to a 
data set 









Are any volumes to be removed from 
the candidate list for the data set? 


Yes No 










Is this a CRA volume for a NOALLOCATE 


data set 
SEE Return 


No Yes 


Confirm that a volume catalog record exists 
to describe each candidate volume. 


See Diagram DC, Search: Retrieve a Catalog 


Record. 


Update each volume’s catalog record to 
add the data catalog record identifier to 
the data set directory entries, and update 
the CRA if the catalog is recoverable. 


. Update the data catalog records to add a —>€) 


volume information group occurrence to 
describe the candidate volume, and update 
the CRA if the catalog is recoverable. 


See Diagram DL, Modify a Catalog Record 
Field’s Value. 





Procedure Description 


14. 


IGGPEXT 
IGGPALVL 
IGGPALVA 
IGGPSALL 


IGGPALVA 
IGGPEXT 
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Module 
{GGOCLBE 


IGGOCLAR 
IGGOCLBE 
IGGOCLAV 
IGGOCLBE 


IGGOCLEG 
IGGOCLBE 


R15 


VSAM catalog 


Data 
record 


Volume 
record 









Procedure 


IGGPALVA 
{GGPALSA 
IGGPSALL 
IGGPALSA 
IGGPMOD 
IGGPALSA 
IGGPALEC 
IGGPGET 
IGGPALVR 
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Diagram EK4. ALTER: Modify a Catalog Record 






Remove candidate volume informa- 
tion from a data catalog record 








VSAM catalog 






. Is the data set NOALLOCATE? 


Yes No >> (17) 
S R15 


16, Is this the last VIGO in the catalog record? ————— I Rewurn code | 
No Yes AAD Return 






Data or index 
Catalog record 





: 


17. Update each candidate volume’s catalog 
record to delete the data catalog record’s 
identifier from the data set directory entries, 
and update the CRA if the catalog is 
recoverable, 


(cy > 18. Update the data catalog record to remove Se) 


each candidate volume’s volume informa- 
tion group occurrence, and update the CRA 
if the catalog is recoverable. 


See Diagram DL, Modify a Catalog Record 
Field’s Value. 





Description Module Procedure 


17. IGGOCLBN IGGPALVR 


18. Note: If the catalog is recoverable, 
the call to I|GGOCLEG will result in IGGOCLBN !tGGPALVR 
a CRA update unless bit CCARPUT IGGOCLAV IGGPMOD 


(the ‘update inhibit’’ bit) is set to IGGOCLBN IGGPALVR 
‘1’, This bit is set in the calling pro- IGGOCLAZ IGGPEXT 
cedures, which decide whether IGGOCLBN !tGGPALVR 
CRA updating is necessary for a IGGPALVE 
given operation. IGGOCLEG IGGPGET 


IGGOCLBN IGGPALVE 
IGGOCLAV !IGGPMOD 
IGGOCLBN  IGGPALVE 
IGGOCLEG IGGPPUPC 
IGGOCLBN. IGGPALVE 
IGGPALVR 

IGGOCLAV {GGPMOD 
tGGOCLBN IGGPALVR 
IGGOCLBE IGGPALEC 
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Diagram EL1. LISTCAT: Retrieve a Catalog Record’s Contents 


R11 






CCA 
CTGPL 













Catalog 
DSNAME, 
or 0 


Request 
options 


TGFL 






“Multitype’’ 
CTGFL 


List of the 
types of 
records 
requested 







a) 





b) 







Catalog management buffer 






Catalog record 
Record type 






Notes for Diagram EL1 


Description Module 
The LISTCAT command allows the user to 
list all or a part of a VSAM catalog’s contents. 


This routine, however, can return only 
information from one record (including 
extension records, if any are present) each 
time it is called. It is AMS’s responsibility 
to specify the starting point for the search 
operation, so that records which have 
already been processed are not retrieved 
again. This applies regardless of whether 
LISTALL has been specified or only certain 
types of records are to be handled. 

1. IGGOCLBQ 
IGGOCLBM 
2. The caller can request the information IGGOCLBO 
contained in a specific catalog record 

by providing the record's DSNAME (for 

a cluster, nonVSAM data set, or catalog) 

or volume serial number (for a volume). 
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Verify the user’s authorization to read the 
catalog information requested. 


Retrieve the catalog record specified by 
the caller. 


See Diagram DC1, Search: Retrieve the Base 
Catalog Record. 


Did the caller supply the catalog’s DSNAME? 


Did the caller specify the LISTALL option? 
Search for, and retrieve the first record.which 


Build the CTGFLs necessary to obtain 
the catalog record fields’ values. 


Obtain the catalog record fields’ values >) 


that satisfy the caller's request. 


See Diagram DK1, Obtain a Catalog Record 
Field’s Value. 


Caller’s CTGPL 


tcatalog’s 
DSNAME 









=O 


Yes No Catalog’s 


DSNAME 


4. Return the catalog’s DSNAME 
to caller. 


Built by step 7 


No Yes 


CTGPL 


ou ) 


is of the specified type, and 
CTGFLs 





satisfies the test byte (if specified). 


CTGFLs 


To identify 
each field 
in a data, 
index or 


or 


cluster 
catalog 
record 


CTGFLs 


To identify 
each field 
in a volume 








catalog 
record 





R15 
Return 
Description Module Procedure 
Procedure See DOS/VS VSAM - Extended: Using 
VSAM-E Commands and Macros, for 
details about the ENTRIES parameter. 
The true-name catalog records contain 
the DSNAME of each cluster and non- 
VSAM data set described in the catalog. 
Each true-name record also contains the 
control-interval number of its associated 
catalog record. 
6. IGGOCLBOQ - ==IGGPLSTC 
IGGOCLEG IGGPGET 
8. IGGOCLBQ ==-IGGPLSTC 
IGGOCLAZ IGGPEXT 
IGGPLSTC 
IGGPCKAU 
IGGPLSTC 
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Diagram EM1. DELETE: Remove a VSAM or NonVSAM Data Set 


No 


Request 
options 






COMREG 








Notes for Diagram EM1 
(for nonVSAM) 


Description Module 

A. For CTGTYPE = A, control is transferred IGGOCLBG 
to the delete alien driver, 

B, The VTOC of the volume in which the IGGOCLBG 
nonVSAM resides is updated only if 1GGOCLA7 
“scratch” is specified. IGGOCLAZ 
(The volume information is extracted from {!GGOCLA7 
the ‘A’ record. A check is done if the IGGOCLBG 
volume is mounted, and the label is 1GGOCLA7 
scratched from the VTOC). IKOASNMT 

\GGOCLA7 
IGGOCLBG 
IGGOCLA7 
IKOQSCROO 
IGGOCLA7 
C, The ‘A’ record is deleted from the catalog. !GGOCLBG 
IGGOCLAN 
IGGOCLEG 
!{GGOCLAN 
IGGOCLBG 
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Yes 


See the notes A,B, and C for this diagram. 


Yes 


Procedure 


IGGPDEL 
IGGPDELA 
1GGPDEL 


IGGPDELA 
IGGPDEMV 
IGGPEXT 
IGGDEMV 
IGGPDELA 
\GGPDVMV 


IGGPDVMV 
IGGPDELA 
IGGPDUSC 


|GGPDUSC 


IGGPDELA 
IGGPDUND 
IGGPDDE 

IGGPDUND 
IGGPDELA 


Fa 1. Did the caller specify NONVSAM? 


Check the object's expiration date 
2. Is the PURGE option specified by the user? 
Yes No 


!s the cluster’s expiration date 
value less then the current time 
stamp value? 








CCACD1 


No SLED Return Error cote] 


Module Procedure 


Description 


Note: If the catalog is recoverable, the call to 
IGGOCLEG will result in a CRA update unless 
bit CCARPUT (the “update inhibit’ bit) is set 
to ‘1’. This bit is set in the calling procedures, 
which decide whether CRA updating is necessary 
for a given operation. 


The DELETE command enables the user to remove 
from the catalog all information about a specified 
cluster or nonVSAM data set. 


1, 


The catalog record identifier is examined to IGGOCLBG IGGPDEL 
determine the record type and verify that 
the contents of the parameter list field 


CTGTYPE are correct. 


For processing of a nonVSAM delete 
(CTGTYPE = A), see notes A,B, and C. 


lf the user specified PURGE, the data 


set’s expiration date is ignored. 


IGGOCLBG IGGPDEL 


If the user who created the data set {GGOCLBG IGGPDEL 
specified an expiration date, the data set can- 
not be deleted until after that date (unless the 


PURGE parameter is specified: see step 2). 
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Diagram EM2. DELETE: Remove a VSAM or NonVSAM Data Set 






Expiration 
jate 


VSAM Catalog tData catalog 


record 


Hid 















naex 
catalog 
record 


TAIXx catalog 
recor 






Cluster 
catalog record 







fPath catalog 
record 


ae 


Notes for Diagram EM2 
Description 


4. \f the user wants to delete a path, control 
is transferred to the delete path driver. 


5. If the user wants to delete an alternate 
index, control is transferred to the delete 
AIX driver. 


6. If the user wants to delete a cluster, 
control is transferred to the delete cluster 
driver. 


7, The upgrade set is retrieved via the 
cluster’s data record containing the 
upgrade set (Y) association. In order to 
avoid having to update the Y record each 
time an AIX related to this cluster is 
deleted, the Y record is deleted at this 
point. 


. Did the caller specify PATH? 


1-4 


Did’ the caller specify AIX? 


Yes 


See A EP, DELETE Path or AIX. 


j See Diagram EP, DELETE Path or AIX. 





Did the catler specify CLUSTER? 


Yes 





CCACD1 


No COE Return 


. 1s art upgrade set associated with this cluster? 


Yes No 


, 


Remove the upgrade set association group 
occurrence from the cluster’s data component 
record, 


Module 


1GGOCLBG 
IGGOCLCX 
IGGOCLBG 


IGGOCLBG 
IGGOCLCX 
IGGOCLBG 


IGGOCLBG 


IGGOCLBG 
IGGOCLCX 
IGGOCLBG 


|\GGOCLCX 
IGGOCLAV 
IGGOCLCX 
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Procedure 


IGGPDEL 
IGGPDELX 
IGGPDEL 


IGGPDEL 
IGGPDELX 
IGGPDEL 


IGGPDEL 
IGGPDLCL 
IGGPDEL 


IGGPDLCL 
IGGPDELY 
IGGPDLCL 


IGGPDELY 
{GGPMOD 
IGGPDELY 


Description Module Procedure 
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Diagram EM3. DELETE: Remove a VSAM or NonVSAM Data Set 


9. Rewrite the upgrade set record into the | 


catalog as a free record. 


VSAM catalog 


Upgrade set 
catalog record 


AIX 

catalog record 
Path 

catalog record 
Path 

catalog record 
Cluster 
catalog record 
True-name 
catalog record 





The following steps (10 to 26) are carried out for: 


a) each AIX (if any) related to the cluster, and 






b) the cluster itself. 








10. Is the object to be deleted in use (open)? 


No Yes cir Return 


11. Is any path defined over the cluster or Al X? 


Yes No 


Do steps 12 and 13 for each path: 


12. Remove the path association group occurrence 
from the cluster or AlX record. 






13. Rewrite the path catalog record as a free 
catalog record, and erase the path’s true- 
name record. 






Notes for Diagram EM3 for the cluster itself: for each AIX related to the cluster: 
Module Procedure Module Procedure 
Description Module Procedure 
13. Note: If the catalog is recoverable, the call to |GGOCLEG will result 
9. Note: If the catalog is recoverable, the call I!GGOCLCX IGGPDELY in a CRA update unless bit CCARPUT (the “update inhibit’ bit) 
to IGGOCLEG will result ina CRA update IGGOCLEG IGGPPDE is set to ‘1’. This bit is set in the calling procedures, which decide 
unless bit CCARPUT (the ‘‘update inhibit’’ |GGOCLCX IGGPDELY whether CRA updating is necessary for a given operation. 
bit) is set to ‘1’. This bit is set in the calling 
procedures, which decide whether CRA IGGOCLAV IGGPMOD IGGOCLAV !IGGPMOD 
updating is necessary for a given operation. IGGOCLBG IGGPDLCL IGGOCLCX IGGPDAIX 
for the cluster itself: for each AIX related to the cluster: IGGOCLBG IGGPDLCL IGGOCLCX IGGPDAIX 
Module Procedure = Module Procedure IGGOCLEG IGGPPDE  IGGOCLEG IGGPPDE 
IGGOCLBG IGGPDLCL IGGOCLCX IGGPDAIX 


10. A delete request is rejected if the data set is open. The information 
indicating that a data set is open is kept in the Lock Table. 


IGGOCLBG IGGPDLCL IGGOCLCX IGGPDAIX 
IGGOCLCX IGGPDELO IGGOCLCX IGGPDELO 


IGGOCLCX IGGPDELO IGGOCLCX IGGPDELO 
IGGOCLBG IGGPDLCL IGGOCLCX {!GGPDAIX 


- 12. IGGOCLBG IGGPDLCL IGGOCLCX IGGPDAIX 
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CCACD1 








Free 
catalog record 









VSAM catalog 


Free 
catalog record 


Erased 
true-name record 
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Diagram EM4. DELETE: Remove a VSAM or NonVSAM Data Set 








CTGPL 


Do steps 14 and 15 for the base cluster only: 








——— 14. Is the ERASE option specified by the user? 
No Yes 


Request options 


VSAM catalog j 15. Overwrite each record in the 


user's data set with Os. 





Data set’s 
records set to 0 















Volume information 
group occurrence 


Volume serial 
number 















Data, index, 
or nonVSAM 
catalog record 


See Diagrams BA and GA, Open 
and Close Data Sets. 


CCA 


management buffer 


Volume catalog record 







Data set's records 





Update the volume catalog records 


Do steps 16 through 26 to process each volume 
information group occurrence in the data and/or 
index catalog record: 






“Deleted” flag ON in 
pointer to the data set 
directory group 
occurrence 














16. Retrieve the volume catalog record 
identified by an RBA or a key value. 





Data set directory 
entry group occurrence 


See Diagram DC1, Search: Retrieve the Base 


@) Catalog Record. 


' 17. Delete the Data Set Directory group occur- 
rence identified by the data and/or index 
catalog record's control interval number. 






Contro, interval 
number of the 
object's 
catalog record 


Volume 
catalog 
record 











See Diagram DL1, Modify a Catalog Record 
Field’s Value. 


Notes for Diagram EM4 Description Module Procedure 
Description Module Procedure IGGOCLA7 IGGPDEDD 
IGGPVMSC 
14. Each of the cluster data set’s records is {GGOCLBG IGGPDLDS 
sequentially retrieved and overwritten IGGOCLA7 IGGPERAS 
with Os. SAM ESDSs with NOCIFORMAT $$BOPEN 
are not overwritten with zero’s. IGGOCLA7 IGGPERAS 
$$BCLOSE 
IGGOCLA7 !GGPERAS 
IGGOCLBG IGGPDLDS 
16. IGGOCLBG iIGGPDLDS 
{GGOCLEG IGGPGET 
IGGOCLBG IGGPDLDS 
17, The volume catalog record also contains a IGGOCLBG !GGPDLDS 
data set directory group occurrence to IGGOCLA7 |IGGPVMSC 
describe each VSAM data set that is IGGPDEMV 
contained, partially or completely, on the IGGOCLAZ IGGPEXT 
volume. If the volume is a candidate IGGOCLA7 iIGGPDEMV 
volume for a data set or index, the data IGGPVMSC 
set or index is also described by a data set IGGPDEDD 
directory group occurrence. IGGOCLAZ IGGPEXT 
IGGOCLA7 IGGPDEDD 
IGGOCLAV IGGPMOD 
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Diagram 


Catalog 
management 
buffer 








Volume 
catalog 
record 























Data space group 
occurrence 
(1 per data space) 


















“Unique’’ flag 
Number of VSAM 
objects in the 
data space 


Notes for Diagram EM5 


18-21 


2.122 


Description Modules 


The volume catalog record contains a IGGOCLA7 

data space group occurrence to des- 

cribe each VSAM data space on the !GGOCLAZ 

volume. IGGOCLA7 
IGGOCLAV 
IGGOCLA7 


VSE/VSAM VSAM Logic, Volume | 


Update the data space information in the 
volume catal 


Do steps 18 through 25 to process each data space 
that contains part of the data set and/or index 
records on the volume identified in step 16. 


record 





T—— > 18. Retrieve the data space group occurrence. 


A 19. Was this a UNIQUE data set? 


No Yes 


20. Delete the data space group 
occurrence. 


ne 


21. Update the data space group occurrence 
to show one less data set. 


Procedure 


IGGPVMSC 
IGGPDESH 
IGGPEXT 

IGGPDESH 
IGGPMOD 

IGGPDESH 
IGGPVMSC 


EM5. DELETE: Remove a VSAM or NonVSAM Data Set 


Catalog management buffer 


<| updated volume catalog record 
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Diagram EM6. DELETE: Remove a VSAM or NonVSAM Data Set 













Catalog : 

pled 

ment 
Starting CCHH \ 





Number of tracks 
allocated to 
VSAM objects 


















Describes the VSAM 
data space as a 


VSE data set 











Form 1 label 
(identifier) 





Volume information 
group occurrence 
extent descriptors 

(1 per extent in the 
volume) 






Catalog 
management 
buffer 























Data, index, 
or nonVSAM 
catalog record 


Sequence number 
of the data 
space group 


Starting CCHH 
address 











Ending CCHH 
address 


Notes for Diagram EM6 
Description Module 


23. If the data or index space is unique, its IGGOCLA7 
data space is also deleted. Before the data 


space is deleted, the volume containing it IKQASNMT 
is mounted. IGGOCLA7 


The volume containing the data space is 

optionally specified by the FILE parameter. |KQSCROO 
IGGOCLA7 

The extents in the data space’s format-1 

label and format-3 label, if present, are 

scratched from the VTOC. 


24. Each entry in the list identifies one of the IGGOCLA7 


data set or index extents in one of the data 
spaces on the volume. IGGOCLAZ 
IGGOCLA7 
25, Each of the data space’s extents is IGGOCLA7 
described in the data space group IGGOCLBF 
occurrence. 
IGGOCLAZ 
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Release the data set’s space 


Ye 


Procedure 


{GGPVMSC 
IGGPDVMV 


IGGPDVMV 
IGGPVMSC 
IGGPDUSC 


IGGPDUSC 
IGGPVMSC 


1GGPVMSC 
IGGPDEVG 
IGGPEXT 

IGGPDEVG 
IGGPVMSC 


IGGPVMSC 
|GGPSSCR 
IGGPESDG 
IGGPEXT 


22. Was this a UNIQUE data set? 


Update the ‘tracks used” value. 


27, 


Do steps 22 through 25 to release all of the data 
set and/or index space on a VSAM volume: 


23. Delete the VSAM data space. 
See Diagram FD, Scratch 
VTOC labels. 


24. Build a list describing each of the data set's 
extents in the data space. 


25. Modify the space map group occurrence 
based on each entry in the data set’s extent 
list to: 


@ Update the space map to show the tracks 
allocated to the data set are now unallocated. 





26. Update the volume catalog record to show one 
less data set on the volume. 


If the data component of a KSDS or of an AIX 
has just been processed, return to step 10 to 
process the index. 


Description 











VSAM-owned volume 


Released VSAM 
data space 







Available space ina 
nonunique data 
space 









Catalog management buffer 























Module 
IGGOCLBF 
IGGOCLAV 
IGGOCLBF 
IGGOCLA7 


IGGOCLBG 


Section 2. Method of Operation 


Updated volume catalog record 





Procedure 


IGGPSSCR 
1GGPSCAN 
IGGPMRLC 
IGGPMOD 
IGGPSSCR 
IGGPVMSC 


IGGPDLDS 
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Diagram EM7. DELETE: Remove a VSAM or NonVSAM Data Set 


VSAM catalog VSAM catalog 


Goya pote ie ee ee 


28. Rewrite the data and/or index catalog 
record into the catalog as a free catalog 
record. 






















29. Rewrite the cluster or AIX catalog record 
into the catalog as a free record. 





Cluster catalog 
record 


Free catalog 
record 


Erased 
true-name 
record 


30. Erase the data set’s and/or index’s true- 
name catalog record. 





Data catalog 
record 


Index catalog 
record 

AIX 

catalog record 


Data set 
catalog record 





31. Erase the cluster’s or AIX'‘s true-name catalog 
record, 









> Return 





Index catalog 
record 






True-name 
catalog record 


Notes for Diagram EM7 


Description Module Procedure 

28-31, The delete routines erase the data IGGOCLBG IGGPDLDS 

set's true-name record and delete IGGOCLAN IGGPDUND 

all references to the data set's IGGPDEUN 
DSNAME in the catalog’s index. IGGOCLEG IGGPGET 
IGGPDDE 

IGGOCLAN [tGGPDEUN 

IGGPDUND 


IGGOCLBG IGGPDLDS 
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Diagram EN1. DELETE Space: Release All of the Empty VSAM Data 


Space on a Volume 


1. Confirm that the volume is mounted. 





“Diagrams EB, EO 


Message to “4255A Wrong 
operator pack, mount 
annnnn” 


Check if the volume is to be freed 


VSAM catalog 











Volume 
catalog record 





VSAM data 
set’s volume 


F4 labe Se) 


VSAM data space 
to be released 













VTOC 


il 





Release the VSAM data space 


Do steps 3 and 4 for each empty VSAM data 
space on the volume: 


3. Delete the empty and nonunique data space 
entry from the volume catalog record. 


4, Release the VSAM data space and make 
it available to the system. 


2. Is the volume empty or is delete space to be 
forced? 











F4 label 










Released 
VSAM 
data space 


See Diagram FD, Scratch VTOC Labels. 





Update the volume catalog record 







Notes for Diagram EN1 


Description Module 


6. Update the timestamp in the volume catalog 
record. 


Rewrite the updated volume catalog 
record into the VSAM catalog. 


Return 


Procedure 


The DELETE space command enables the user to release all VSAM data 


spaces on a specified volume. 


1. If the volume isn’t already mounted and IGGOCLBL 
available for use, the DELETE space routine 

issues the appropriate mount message to IKQASNMT 

the operator. IGGOCLBL 

IKQVDTPE 


2. Avolume is empty when its volume catalog IGGOCLBL 
record contains no data set directory group 


occurrence (which normally describes data !GGOCLAZ 
sets on the volume). ‘‘Force” is an option IGGOCLBL 
the user may specify to delete a volume 

even though there are still data sets on this 

volume. 

3. The volume catalog record contains adata 1IGGOCLBL 
space group occurrence to describe each IGGOCLAZ 
VSAM data space on the volume. IGGOCLBL 

IGGOCLAV 
IGGOCLBL 
IGGOCLAV 


Licensed Material — Property of IBM 


IGGPDELS 
IGGPDLVM 


IGGPDLVM 


IGGPDELS 
{GGPDLVC 
IGGPEXT 

1GGPDLVC 


IGGPDELS 


{GGPDLCD 
IGGPEXT 
IGGPDLSH 
1GGPMOD 
IGGPDLSD 
IGGPMOD 


Update the timestamp in the volume’s ==) 


| { Format 4 VTOC Label. 


VSAM catalog 


Updated volume 
catalog record 


= 





Description Module 
. The DADSM routine IKQSCROO releases IGGOCLBL 

VSAM data space and makes its space 1KQSCROO 

available to other VSE system users. 

The timestamp in the VTOC is updated to !GGOCLBL 

indicate when the last change to the VTOC 

was made by VSAM. IGGOCLBU 
IGGOCLBL 
IGGOCLBU 
IGGOCLBL 
IGGOCLBL 

Note: If the catalog is recoverable, the IGGOCLBL 

call to IGGOCLEG will result ina CRA IGGOCLEG 

update unless bit CCARPUT (the ‘‘update IGGOCLBL 


inhibit’’ bit) is set to ‘1’. This bit is set in 

the calling procedures, which decide whether 
CRA updating is necessary for a given 
operation. 


Section 2. Method of Operation 


vToc 


Procedure 


IGGPDLSC 


1GGPDELS 
IGGPDLTS 
IGGPF4RD 
iGGPDLTS 
iIGGPF4WR 
IGGPDLTS 


IGGPDELS 
IGGPDELS 


IGGPPUPC 
{GGPDELS 
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Diagram EN2. DELETE Space: Release All of the Empty VSAM Data 
Space on a Volume | 













VSAM 
catalog 


Volume catalog 
record 
Noss seraiesion 7 


Data or index 
catalog record 


VSAM data 
set's volume 


VSAM data space 
to be released 






Notes for Diagram EN2, 

























. Close the CRA. 


. Search for CAXWAs for this.CRA in other 
partitions and mark them as deleted. 


12. 


Description Module 
8. Ifa volume owned by a recoverable IGGOCLBL 
catalog is to be freed, its CRA will be 
scratched. Care must thus be taken that 
no partitions will use this CRA again. 
9. By closing the CRA, all control blocks in IGGOCLBL 
the requesting partition will be freed. . 
IGGOCLCO 
IGGOCLBL 
$$BCLOSE 
IGGOCLBL 
10, The control blocks for the CRA are erased IGGOCLBL 
at the end of the current job (which issued $$BCLCRA 
the DELETE SPACE command). I, IGGOCLBL 
however, a job in another partition issuesa IGGOCLBL 
DEFINE SPACE for the same volume 
before the end of the current job, the 
DEFINE SPACE routine must know that 
is has to build a new CRA. For this reason, 
the CRA’s control blocks in all other 
Partitions are marked invalid. 
2,126 VSE/VSAM VSAM Logic, Volume | 


Yes 


Yes 


volume? 
No 


No 


No 


No 


Yes 


Procedure 


IGGPDELS 


IGGPDELS 
IGGPDLCR 
IGGPSCAX 
IGGPDLCR 


IGGPDLCR 
IGGPDLCR 


IGGPDLCR 
IGGPDELS 


Yes 


Is the catalog recoverable? ; 


> ('') 


Did the user specify ‘force delete space’’? 


meen (12) 


Update the data set catalog records 


Is the ‘force delete” specified for the catalog 


o> Return 


Are any of the data sets on the volume in use? 


CEE Return 


Flag the catalog records of all data sets on 
this volume as unusable. 


13. 










CCACD1 





CCACD1 


| Errorcode | 


LErrorcode | 










Description 


As long as any of the data sets on the 
volume is in use, the forced delete space 
is rejected. 


The catalog records of all data sets on the 
volume are flagged as unusable. Since their 
space will be partly or completely gone, 
they are thus marked to inhibit any open 
requests for output, and to warn CMS 
delete cluster. (CRA duplicates may be 
gone; volume occurences may point to 
non-existing volumes.) 

Note: If the catalog is recoverable, the call 
to 1|GGOCLEG will result ina CRA update 
unless bit CCARPUT (the “update inhibit” 
bit) is set to ‘1’. This bit is set in the calling 
procedures, which decide whether CRA 
updating is necessary for a given operation. 


VSAM catalog 


eta es 
Index or data 
catalog record 





Module 


IGGOCLBL 
IGGOCLCL 


IGGOCLAZ 
IGGOCLCL 
I{GGOCLCX 
IGGOCLCL 


IGGOCLCL 


{GGOCLAZ 
IGGOCLCL 
IGGOCLEG 
IGGOCLCL 
IGGOCLEG 
IGGOCLCL 


IGGOCLAV 
IGGOCLCL 


Procedure 


IGGPDELS 
IGGPDLSF 
1GGPDXDS 
IGGPEXT 
IGGPDLSF 
{GGPDELO 
IGGPDLSF 


iGGPDLSF 
IGGPDXDS 
IGGPEXT 
IGGPDLSF 
IGGPGET 
|GGPDLSF 
|GGPPUPC 
|GGPDLSF 
IGGPDMDS 
IGGPMOD 
IGGPDLSF 
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Diagram EN3. DELETE Space: Release All of the Empty VSAM Data 
Space on a Volume 





14. Is the volume a candidate volume? 


;  —o 


15. Is ita CRA volume or last volume for 
on NOALLOCATION data set? 


Yes — (7) 


| | No 
—> 16. ¥... volume information group 
| | occurance from data set record. VSAM catalog 


| | Index or data 
17. Flag the catalog record of the data —_—_—_———> 
set ‘‘unusable”’ VSAM date 


| set’s volume 


18. Scratch all VSAM labels from the VTOC == CS 













of the volume. 
' F4 label vToc 
See Diagrams FD and FF. Read and Scratch 


VTOC labels. 





Released 


VSAM 
data space 


Notes for Diagram EN3. 


Description 
Module Procedure 
14. The catalog records of all data sets with {GGOCLCL IGGPDLSF_ 18. The VTOC is scanned for VSAM VTOC labels, and all VSAM VTOC 

space on this volume are flagged as un- IGGPDXDS labels are scratched thus returning all space occupied by VSAM to 
usuable, since their space will be partly IGGOCLAZ IGGPEXT the VTOC. 
or completely gone, they are thus marked IGGOCLCL IGGPDLSF empty vol.: force delete: empty vol.: force delete: 
to inhibit any open requests for output, IGGOCLEG {GGPGET 
and to warn CMS delete cluster. If this is IGGOCLCL IGGPDLSF IGGOCLBL IGGOCLCL IGGPDELS IGGPDLS 
a candidate volume, the data set remains IGGOCLEG IGGPPUPC IGGOCLCL IGGPDVSC 
usable and the volume is removed from IGGOCLCL IGGPDLSF IKOVTCOO 
the data set's candidate list. (CRA |GGPDMDS IGGOCLCL IGGPDVSC 
duplicates may be gone: volume oc- IGGOCLAV IGGPMOD iKORDSOO 
curances may point to non-calsting IGGOCLCL IGGPDLSF iGGOCLCL IGGPDVSC 
volumes.) IKOSCROO 
Note: \f the catalog is recoverable, the IGGOCLCL IGGPDVSC 
call to I|GGOGLEG will result ina CRA IKOVTCOO 
update unless bit CCARPUT (the ‘‘up- IGGOCLCL IGGPDVSC 
date inhibit’ bit) is set to ‘1’. This bit IGGOCLCL 1GGPDSF 
is set in the calling procedures, which {GGOCLBL IGGPDELS 


decide whether CRA updating is nec- 
essary for a given operation. 


Volume only being used Volume only being used as Volume being used as both Volume has no data set 
for data space (No candidate) candidate (no file space) candidate and file space directory group occurance 
Delete 
Space (not forced) DELETE fails DELETE fails DELETE fails 


@ Files having space on @® Candidate volume group ®@ Files having space on the 
volume are marked occurances (VGO) are vol are marked unusable 
* unusable. deleted if @ Candidate vol G.O.’s are 
@ DELETE successful - not last VGO for file deleted if 
- not CRA vol for file - not V.G.O. for file 
else file marked ususable. - not CRA vol for file 
® DELETE successful else, the file is marked 
ususable. 
@ DELETE is successful 

















DELETE successfu! 























Delete 
Space 
(Forced) 














DELETE successful 
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Diagram EN4. DELETE Space: Release All of the Empty VSAM Data 


Space on a Volume 





VSAM catalog 





Volume catalog 












VSAM data 
set’s volume 


F4 label 


the volume. 







VTOC labels. 


Return 
Notes for Diagram EN4 
Module Procedure 
empty vol.: force delete: empty vol.: force delete: 


19, Reset the volume record and all its extension records so that it is 
available for future assignment. 


IGGOCLBL IGGPDELS 

1GGPDLET 
IGGOCLEG 1GGPGET 
IGGOCLBL {GGPDLET 
IGGOCLEG |GGPPDEC 
IGGOCLBL IGGPDLET 


20. The format-4 label is the first entry in a direct-access volume’s 
VTOC. It contains the volume owner’s identification and information 
on how the volume is used. 


2.128 VSE/VSAM VSAM Logic, Volume | 


é > 19. Rewrite the volume catalog record into 
iiss | | the VSAM catalog as a free catalog record. = 


20. Update the volume’s format-4 VTOC 
label to show no VSAM ownership of 


VSAM data 
set’s volume 
See Diagrams FF and FG. Read and Write 





Delete the volume catalog record 


VSAM catalog 





Free catalog 
record 





F4 label 


Note: \f the catalog is recoverable, the call to |GGOCLEG will result 

in a CRA update unless bit CCARPUT (the ‘update inhibit’ bit) is 

Set to ‘1’, This bit is set in the calling procedures, which decide whether 
CRA updating is necessary for a given operation. 


IGGOCLBL IGGPDLET 
!GGOCLBU !GGPF4RD 
IGGOCLBL 1GGPDLET 
tGGOCLBU IGGPF4WR 
IGGOCLBL IGGPDLET 

IGGPDELS 
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Diagram EO1. DELETE Catalog: Release a VSAM Catalog 





Supervisor 






1. 





Is the catalog in use? 


No Yes nooo 
o> 





CCACD1 


ANCHT 


VSAM catalog 


¥ 










See ae Es “> 2. Is the catalog empty? 
! 
True-name records } Yes No Return 
For catalog’s ) Volume that 
DSNAME id contained the 
¢ 
.. Release a catalog’s data spaces VSAM catalog 









~ 
For catalog 1 a. 
volume’s serial | | 
qumber L. —-- 


+, 3. Release all empty data spaces. 
Free space 


See Diagram EN1, Delete Space: Release all 
of the Empty Data Spaces on a Volume. 





User's partition Delete the VSAM catalog 


Master catalog 





4. Which type of catalog is specified in the 
DELETE command: 


Master 
User catalog Catalog 


5. Delete the user catalog entry (‘U’ record) 
in the master catalog. 


os 6. Close the catalog and scratch its VTOC 
label(s). 
Control blocks 


that describe See Diagram GA, Close Data Set. 


Closed ACB 





we vee ation A See Diagram FD, Scratch VTOC Labels. 


7. Release all control blocks that allow catalog 
| | records to be processed. 


Return 





CCACD1 


Notes for Diagram EO1 Description Module 


6. The communications region (COMREG) IGGOCLAF 
Points to the ANCHT which points to the IGGOCLAL 
AMCBS. The AMCBS points to the control IGGOCLAF 
blocks that describe the VSAM catalog to IGGOCLEG 


Description Modute Procedure 


The DELETE catalog command enables the user to release a catalog’s 
space and make it availiable to other VSE system users. The catalog 


b i Sarat the system. IGGOCLAF 
must be empty or the request is rejected. IGGOCLEG 
; IGGOCLAF 

1. By attempting to LOCK the catalog for IGGOCLAF Note: If the catalog is recoverable, the call !tKOQVDTPE 
exclusive uselt:may ‘be cetermined to |GGOCLEG will result ina CRA update IGGOCLAF 
wether it is currently in use. unless bit CCARPUT (the “update inhibit’ 1GGOCLAZ 

2. If the catalog contains more than two true- IGGOCLAF IGGPDELC bit) is set to ‘1’. This bit is set in the calling !GGOCLAF 


procedures, which decide whether CRA $$BCLOSE 


name records, it is not empty and cannot rea } : 
nes pe updating is necessary for a given operation. {GGOCLAF 


be deleted. 

3. The volume catalog record contains an entry |GGOCLAF IGGPSDSP IKOSCROO 
for each VSAM data space allocated on the 1GGOCLAF 
volume. Each entry contains the data neces- IGGOCLBU 
sary to free the data space. IGGOCLAF 

|KOASNMT 

4. One of these type must be specified for a IGGOCLAF 
DELETE CATALOG operation. IGGOCLBU 


5. Each user catalog has an entry in the 
master catalog. 


Released 
control blocks 
(free storage) 

















Procedure 


IGGPDELC 
IGGPDBVC 
1GGPDELC 
IGGPPDE 

IGGPDELC 
\GGPGET 

IGGPDELC 


IGGPDELC 
IGGPEXT 
IGGPDELC 


IGGPDELC 
|GGPSDSP 


IGGPDELC 
IGGPF4RD 
IGGPDELC 


IGGPDELC 
iGGPF4WR 
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Diagram EP1. DELETE AIX or Path: Release an Alternate Index or a 


VSAM Path 





CT 


VSAM catalog 






Path catalog 
record 


Path’s true-name 
catalog record 


Notes for Diagram EP1 


Description 


The DELETE command enables the user to remove from the catalog all 


information about a specified AlX or path. 


1. If the user wants to delete a path, contro} 
is transferred to the delete path driver. 


2. A delete request is rejected if the data set 
is open. The information whether a data 
set is open is kept in the !ook-aside table. 


3-4. The upgrade set is retrieved via the AIX’s 
base cluster data component containing the 
upgrade set association. In case this Al X is 
is the last member in the upgrade set, the 
upgrade set and its association are deleted. 


Note: {If the catalog is recoverable, the call 
to IGGOCLEG will result in a CRA update 
unless bit CCARPUT (the ‘‘update inhibit” 
bit) is set to ‘1’. This bit is set in the calling 


2.130 


a eps 


No 


*Diagrams EB, EM 





Did the caller specify PATH? 


Yes 


Delete a VSAM AIX: 





2. Is the data set to be deleted in use (open)? 
No 


CCACD1 


to caller 


Yes 


De 


Is the AlX a member of an upgrade set for the 
base cluster? 


Yes 


No 


me: ) 


Remove the AIX from the upgrade set. 


Set Diagram ER, Modify the Upgrade Set. 


. Are there any paths defined over the AlX? 


Yes 





No 


Delete al! paths over the AlX; 


Do steps 6 and 7 for each path: 





6. Remove the path association from the AIX 
catalog record. 


> 7. Rewrite the path catalog record as a free 


catalog record, and erase the path’s true- 
a | catalog record. | | 


Module 


IGGOCLBG 
IGGOCLCX 
{GGOCLBG 


{GGOCLCX 
IGGOCLCX 
IKQLASMD 
IGGOCLCX 
IGGOCLCX 


IGGOCLCX 
IGGOCLEG 


!GGOCLCX 
!tGGOCLAZ 
I{GGOCLCX 
IGGOCLCD 
IGGOCLEG 
IGGOCLCD 
IGGOCLAZ 


VSE/VSAM VSAM Logic, Volume | 


VSAM catalog 





Free catalog 
record 














Erased true- 
name record 


Description Module 
Procedure procedures, which decide whether CRA IGGOCLCD 
updating is necessary for a given operation. IGGOCLEG 
!GGOCLCD 
IGGOCLAV 
IGGOCLCD 
IGGPDEL IGGOCLEG 
I1GGPDELP IGGOCLCD 
IGCPPE’ IGGOCLAV 
Peer DES tas IGGOCLCX 
IGGPDELO IGGOCLAZ 
IGGPDELO eater 
IGGPDELX 6. The path association is removed from its IGGOCLCX 
i , G AV 
IGGPDELX AIX before the path is actually deleted eee ie 
ISGESET Note: If the catalog is recoverable, the call 
to IGGOCLEG will result ina CRA update 
ee unless bit CCARPUT (the “update inhibit’ 
bit) is set to ‘1’. This bit is set in the calling 
IGGPDELX : ; 
IGGPUPG procedures, which decide whether CRA 
IGGPGET updating is necessary for a given operation. 
ieGrurS re IGGOCLCX 
Meoreat IGGOCLEG 
IGGOCLCX 


Procedure 


IGGPUPG 
IGGPGET 
IGGPUPG 
IGGPMOD 
iGGPUPG 
IGGPPDEC 
IGGPUPG 
iGGPMOD 


IGGPDELX 
1GGPEXT 
IGGPDELX 


1GGPDPTH 
1GGPMOD 
IGGPDPTH 


IGGPDPTH 
IGGPPDE 
IGGPDPTH 
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Diagram EP2. DELETE AIX or Path: Release an Alternate Index or a 
VSAM Path | 


CTGPL Delete a VSAM AIX (continued): 
Caw! | 
options vege 
“ Ne 8. Remove the AIX association from the 
NN | | base cluster catalog record. 
“N 







VSAM catalog 











Modified 
cluster catalog 
record 










VSAM catalog 


| 
[- 
Wy 






Base cluster 
catalog record 


A\X's data 
or index 
catalog record 


















Volume information 


. Is the ERASE option specified by the 
group occurrence 


user? 
i No : C1) 


10, Overwrite each record in the user’s data 
set with Os. 









See Diagram BA and GA, Open and Close 
Data Sets. 











Data set's 
records 






Update the volume catalog records: 





CCA 
Do steps 11 through 21 to process each volume 
information group occurrence in the data and 


index catalog records of the AIX: 




























Catalog management buffer 







e& —-— — > 11. Retrieve the volume catalog record identi- 
fied by an RBA or a key value. 


Volume catalog record 


“Deleted” flag ON in pointer 
to the data set directory 
group occurrence 





See Diagram DC1, Search: Retrieve the 
Base Catalog Record. 









Data set directory 
entry group occurrence 




























Volume 
catalog 
record 


12. Delete the data set directory group occur- 
rence identified by the data and/or index 
catalog record’s control interval number. 


Control interval 
number of the 
object's 
catalog record 












See Diagram DL1. Modify a Catalog Record 
Field‘s Value. 





Notes for Diagram EP2 


Description Module Procedure Description Module Procedure 
8, The AIX association is removed from its IGGOCLCX IGGPDELX IGGOCLA7 IGGPDEDD 
base cluster before the AIX is actually IGGOCLAV IGGPMOD IGGOCLAV {'tGGPMOD 
deleted. IGGOCLCX IGGPDELX IGGOCLA7 IGGPDEDD 
IGGPVMSC 


10. Each of the cluster data set’s records is IGGOCLBG IGGPDLDS 
sequentially retrieved and overwritten IGGOCLA7 IGGPERAS 


with Os. $$BOPEN 
IGGOCLA7_ .I|GGPERAS 
$$BCLOSE 
IGGOCLA7 IGGPERAS 
IGGOCLBG IGGPDLDS 
11. IGGOCLBG !GGPDLDS 
IGGOCLEG !GGPGET 
IGGOCLBG IGGPDLDS 
12, The volume catalog record also contains IGGOCLBG IGGPDLDS 
a data set directory group occurrence to IGGOCLA7 IGGPVMSC 
describe each VSAM data set that is con- IGGPDEMV 


tained, partially or completely, on the IGGOCLAZ IGGPEXT 
volume. {f the volume is a candidate {GGOCLA7 IGGPDEMV 
volume for a data set or index, the data IGGPVMSC 
set or index is also described by a data IGGPDEDD 
set directory group occurrence. IGGOCLAZ {!GGPEXT 
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Diagram EP3. DELETE AIX or Path: Release an Alternate Index or a 
VSAM Path 








Update the data space information in the 
volume catalog record: 
















Do steps 13 through 20 to process each data space 
that contains part of the data set and index records 
on the volume identified in step 13: 






Data space group 
occurrence 


Catalog (1 per data space) 


management 
buffer 














13. Retrieve the data space group occurrence. 





“Unique” flag 


Number of VSAM 
objects in the 
data space 


~ = 44. Did the AIX have the UNIQUE attribute? 


Yes No 
Catalog management buffer 


15. Delete the data space group occurrence. (ey> Updated volume catalog record 
16. Update the data space group occurrence to =o) 










Volume 
catalog 
record 

















show one less data set. 


















Describes the VSAM 
data space as a 
VSE data set 


Format 1 
label 


(identifier) Release the data set's space: 













Do steps 17 through 20 to release all of the data set 
and/or index space on a VSAM volume: 





Volume information 
group occurrence 
extent descriptors 
(1 per extent in the 
volume) 








17. Did the AlX have the UNIQUE attribute? 


y No 
18. Delete the VSAM data space. 
See Diagram FD, Scratch vio )-————=> 












Catalog 
management 
buffer 










Sequence number 
of the data 
space group 







Data, or 
index 













catalog 
seer Labels. 
19. Build a list describing each of the data set’s 
extents in the data space. 
Starting CCHH 


address 





Ending CCHH 
address 





Notes for Diagram EP3 Description Module Procedure 
Description Module Procedure 19, | Eachentry in the list identifies one of +IGGOCLA7 IGGPVMSC 
the data set or index extents in one of IGGPDEVG 

13-16. The volume catalog record contains a IGGOCLA7  !GGPVMSC the data spaces on the volume. IGGOCLAZ IGGPEXT 
data space group occurrence to describe IGGPDESH IGGOCLA7 IGGPDEVG 


each VSAM data space on the volume. IGGOCLAZ IGGPEXT IGGPVMSC 
IGGOCLA7 IGGPDESH 
IGGOCLAV IGGPMOD 
IGGOCLA7 IGGPDESH 


IGGPVMSC 
18. If the data set or index space is unique, !GGOCLA7 IGGPVMSC 
its data space is also deleted. Before the IGGPDVMV 
data space is deleted, the volume con- IKOQASNMT 
taining it is mounted. IGGOCLA7 IGGPDVMV 
IGGPVMSC 
The volume containing the data space !{GGPDUSC 
is specified by the FILE parameter. 
IKQSCROO 
The extents in the data space’s format-1 IGGOCLA7 IGGPDUSC 
(identifier) {abel and format-3 IGGPVMSC 
(extension) label are scratched from 
the VTOC. 
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Diagram EP4. DELETE AIX or Path: Release an Alternate Index or a 
VSAM Path 


Catalog 
buffer 







Volume catalog 
record 





Release the data set’s space (continued): Volume containing the 


objects records 









management 


















Number of tracks 
allocated to 
VSAM objects 









20. Modify the space map group occurrence based 
on each entry in the data set’s extent list to 







Available space in a 
nonunique data space 








© Update the space map to show the tracks 
allocated to the data set are now 
unallocated. 








VSAM catalog 


AIX catalog 
record 


Data catalog 
record 


Index catalog 
record 


True-name 
catalog record 


© Update the ‘tracks used’’ value. 






VSAM catalog 







21. Update the volume catalog record to show one 
less data set on the volume. 





Free catalog 
record 









Do steps 22 and 23 for the AIX’s data, index, and 
AIX catalog records: 








Erased true-name 


22. Rewrite the catalog record into the catalog as 
record 


a free catalog record. 








-f- 


23. Erase the corresponding true-name catalog 


record, ED Return 
VSAM catalog 






Delete a path 


| 24. Get the path’s base (cluster or AIX) record. | 


25. Remove the path association from this record: 


; l 26. Rewrite the path record as a free record. <> 
> 27. ‘Erase the path’s true-name catalog ie 


Cluster or AIX 
catalog record 








Modified base 
record 


Free catalog 
record 


Erased true-name 
record 









Path catalog 
record 
















Path’s true-name 
catalog record 












Return 
Notes for Diagram EP4 Description Module 
Description Module Procedure in the calling procedures, which decide 
whether CRA updating is necessary for 
20. Each of the data space’s extents is IGGOCLA7 tGGPVMSC a given operation. 
described in the data space group {GGOCLBF IGGPSSCR 
occurrence. IGGPESDG 24. The base cluster or Al X association is IGGOCLCX 
IGGOCLAZ IGGPEXT | extracted from the path and the base IGGOCLAZ 
IGGOCLBF IGGPSSCR record is read. IGGOCLCX 
IGGPSCAN IGGOCLEG 
IGGPMRLC IGGOCLCX 
IGGOCLAV IGGPMOD 
IGGOCLBF IGGPSSCR 25. IGGOCLCX 
IGGOCLA7 IGGPVMSC IGGOCLAV 
IGGOCLCX 
21. IGGOCLBG IGGPDLDS 
26-27. Note: If the catalog is recoverable, the §!GGOCLCX 
22-23. .The delete routine erases the data set’s IGGOCLBG !IGGPDLDS call to |GGOCLEG will resultina CRA !IGGOCLEG 
true-name record and deletes all refer- IGGOCLAN IGGPDUND update unless bit CCARPUT (the “update |GGOCLCX 
ences to the data set’s DSNAME in the IGGPDEUN inhibit” bit) is set to ‘1’. This bit is set 
catalog’s index. IGGOCLEG IGGPGET in the calling procedures, which decide 
IGGPDDE whether CRA updating is necessary for a 
Note: If the catalog is recoverable, the !GGOCLAN IGGPDEUN given operation. 


+ 


call to |GGOCLEG will resultinaCRA IGGOCLBG !IGGPDLDS 
update unless bit CCARPUT (the “update 
inhibit” bit) is set to ‘1’. This bit is set 
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Procedure 


IGGPDELP 
IGGPEXT 
IGGPDELP 
IGGPGET 
!GGPDELP 


IGGPDELP 
IGGPMOD 
IGGPDELP 


IGGPDELP 


IGGPPDE 
IGGPDELP 
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Diagram ER1. Modify the Upgrade Set 








*From Diagrams El, EK 










1. 





Is an AIX to be added to the upgrade set? 


Yes No 


Add an AIX 


I ; 
2. Is an upgrade set already defined for the 
base cluster? 


+ Yes p>’) 


3. Obtain a free record and assign it to ihe 
upgrade set. 







Catalog management 
buffer 


Free catalog record 




















VSAM catalog 7 





VSAM catalog 













Data record 
of base cluster 




















Alternate 
index record 






SS . Build an association group occurrence to 
point to the data and index records of 


the AIX. 
OR 5. Write the new catalog record. 
6. 


Modify the data record of the base 
cluster by adding an association group 


occurrence for the upgrade set record. 
ED Feturn 


7. Modify the upgrade set record by adding 
association group occurrences for the data 


and index of the AIX. 
SE Return 


New upgrade 
set record 














Modified data 
record of 
base cluster 












Upgrade set 
record 



















Modified 
upgrade set 


: record 


Module 
or procedure 


IGGOCLCA 
IGGPAIX 


IGGOCLCD 
IGGPUPD 


tGGPNUPG 


IGGOCLAV 
IGGPMOD 
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Diagram ER2. Modify the Upgrade Set 


VSAM catalog 


Remove an AIX 







set to be removed? 





Upgrade set 
record 








Yes No 


record. 





Data record of 
base cluster 
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8. Are the last remaining members of the upgrade 


(=) : 9. Rewrite the upgrade set record as a free 


ee TG: Modify the data records for the base 


cluster by removing the association group 
occurrence for the upgrade set record. 


Modify the upgrade set record by remov- 
ing the association group occurrences for 
the data and index of the AIX. 

















data record 








Return 











Modified 
upgrade set 
record . 











Return 
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Module or 

procedure 

tGGOCLCD 

IGGPUPG 

VSAM catalog 

(GGOCLEG 
Free catalog IGGPPDE 
record 

IGGOCLAV 
Modified 1GGPMOD 
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Diagram ES1. SHOWCAT: Display Catalog Information 












User-issued 
SHOWCAT 


macro 




















Obtain storage for CTGPL, CTGFL, and IKQSCAT 
work area. 
Parameter list 
Isa DDNAME specified? 
‘ No —,>(7) 
Label area 3. Build a parameter list for label area search. Parameter list 
4. Retrieve label area information. DDONAME IKOLAB: 
5. Return code 0? GETVIS area 


OLBL record 


Yes No m>(2:) 
DLBL record S 


Save DSNAME and pointer to DSNAME, 


| 


| and free storage obtained by IKOLAB. 
7. Build a CTGPL for the catalog LOCATE SHOWCAT work area 
_- = function. 


Parameter list y 
= 8. Build CTGELs to retrieve basic informa- 


tion (entry type, control interval number, 
and catalog ACB). 


DSNAME 








Notes for Diagram ES1 


1, 256 bytes of storage are needed. 


8, If the Cl number was specified, the contents of catalog fields ENTYPE 
and CATACB are retrieved. If the true-name was specified, the field 
DSTYPNAM must be retrieved instead of ENTYPE, in order to find 
the Cl number. 
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Diagram ES2. SHOWCAT 


: Display Catalog Information 



















Catalog | el FPLs 
9. Retrieve the catalog information. 
Return area 
See Diagram DE1, LOCATE: Retrieve Catalog 
Information. 
10. Return code 0? 
4 R1 
Ais Pea Yes No noOp>(25) 
ae Parameter 
R15 list 
SHOWCAT > 11. Is this a valid entry type? 
return area 
- a | phan Ne roo Return Return 
area 
12. Move the retrieved date into the user’s 
return area. 
CTGPL 
SHOWCAT 13. Is this a data or indes catalog record? jee 
return area Pe DP Vas No 
es v me a 
Ns 14. Build a CTGFL to retrieve AMDS FPL 
a information. Ss 
15. Js this an alternate index or path catalog | 
record? 
ves Ne 
Catalog 
16. Build a CTGFL to retrieve AIX or path 
attributes. Return area 
17. Retrieve the catalog information. 


Notes for Diagram ES2 






See Diagram DE1, LOCATE: Retrieve Catalog 
Information. 






11. Only the following catalog record types may be retrieved with the 


SHOWCAT macro: 


Cluster 

Data 

Index 

Alternate index 
Path 

Upgrade set 
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Diagram ES3. SHOWCAT: Display Catalog Information 










R15 


(See 


Return area 


Catalog 


23; 
24. 
R15 
en 25. 
CTGPL 
| 26. 











CTGFBFLG 
CTGFDBK 


Notes for Diagram ES3 


Return code 0? Parameter list 


Yes No 


OooEp>(25) 


Move retrieved data to user’s return area. 


Build a CTGFL to retrieve the association J 
group occurrences. 


Retrieve the catalog information. 






ser 
return area 


See Diagram DE1, LOCATE: Retrieve 


Catalog Information. oe 


return area 





Return code 0 or 4? 


Yes No 


Free storage for work 
area and control blocks. 


aE Return 


R15 


Interpret the VSAM error code and set. aomracag> iRee | 


Complete the entries in the user’s return | 
area. 


User 
return area 


equivalent SHOWCAT error code. | 


Move VSAM error code, reason code, and 
module name into user’s return area. 


Free storage for work area and control blocks. 





Return 


22. Return code 4 indicates that the return area was too small to accept 
all group occurrences; the information retrieved (as much as would 
fit in the return area) is passed to the user. 


23, Information saved before the LOCATE is restored and the length 
counts are updated. 
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Diagram FA1l. DADSM Contents 


Direct or 
indirect (via 
another DADSM 


module) cal! 
from catalog 
modules 





See Diagrams 
D-E 









Allocate Rename Scratch Read Open and 
data spaces unique VTOC VTOC close 
data set labels label VTOC 





See Diagram FB See Diagram FC See Diagram FD See Diagram FE See Diagram FF See Diagram FG See Diagram FH 
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Diagram FBI. Allocate Data Spaces 


Module 
all Parameter ist _- =» 1. Obtain storage for work area, and store address | peamaten Lis 1KQALLOO 
of work area in DADSM Parameter List. e503 | 


a 
ee, | 
= 
Pf 2 Open the VTOC. 





See Diagram FH1, Open and Close VTOC. IKQVTCOO 
R15 


return code — 


“> 3. Does return code indicate an error? 


Yes No ome (-) 


. A> Return 
Parameter List 


Label record 


DADLKLBL 







4. Does the flag indicate a valid parameter list 
_ ne pointer to the label area record for the data 
set needed? 









Yes fe) Parameter List 


DADLKLBL IKQLAB 


Label area record 
5. Read the label area 


record and set the flag. 
LABEXN 


Have extents been provided? 


Yes No SEO Retuin 


7. Build new label, and write it in the VTOC. rvtoc]| 
vVToc IKQPOP00 
See Diagram FE1, Build VTOC Labels. 
8. Close VTOC. 
See Diagram FH1, Open and Close VTOC. i1KQVTCOO 





LS Return 


Notes for Diagram FB1 
2. A JIB must be built if the file protect feature is present. 
7, — After the new label is built, the DADSEXIT field in the DADSM 


Parameter List is checked. If this field contains an address of a 
DADSM exit routine, that exit is taken. 
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Diagram FC1. Rename Unique Data Set 


R1 






Parameter list 







1. 


DADSNOP 


DADSVTOP 


2 


R15 


=== =» 4. Does return code indicate a 









Parameter List 
th ae 
- 
” 
DADSPROT | 
DADCVHPL. Pieter. ip 
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Obtain storage for work area. 


Does the VTOC need to be opened? 





No Yes 


3. Open the VTOC. 


See Diagram FH1, Open and 
Close VTOC. 


R15 


successful open? 


bono Return | 


lf “security bypass” bit is on, set indicator 
in common VTOC handler parameter list. 


DADCVHPL 






Rename the data set. | 





Close the VTOC (if opened by this routine). 
See Diagram FH1, Open and Close VTOC. 


Free storage. 


Return 


CVHREN 
CVHSCRBP 


Module 


IKORENOO 


IKQVTCOO 


WJHCVHO 


{KQVTCOO 
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Diagram FD1. Scratch VTOC Labels 



















Module 
Rl Parameter List Obtain storage for work area. IKOSCROO 
DADSNOP |‘ ~. 
an ~ “Se 2. Does the VTOC need to be opened? 
ste y 
a fo) Yes 
~ 
“S& 3) Open the VTOC. 
See Diagram FH1, Open and \KQVTCOO 
Close VTOC. 
_--—* 4. Does return code indicate 
al a a successful open? 
No Yes (=) 
a Return 
R15 
Parameter list 5. If “security bypass” bit is on, set indicator DADCVHPL 
Eo il - in the common VTOC handler parameter [ti‘;S;é;~zrY 
PoapsPROT [-~ lists CVHREN 
SaRERAS ge CVHSCRBP. 
~S 6. Erase format 1 label and all associated \JHCVHO 
format 3 labels from the volume. Ga 
7. Close the VTOC (if opened by this routine). my 
See Diagram FH1, Open and Close VTOC. {KQVTCOO 


Free storage. 





Return 
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Diagram FE1. Build VTOC 


Parameter list 
Ri 





R1 


==5 


a ea ee Zp 5. 


Work area 


R15 


7 
— > 7 
~ 
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Labels 


Calculate size of storage required to build 
VTOC labels and store pointer to work 
area in parameter list. 


Module 
or label 


Parameter list 


It Work area _| Work area 


Work area 


t{KQPOPO0O0 






INIT 









DSCBUILD 





Build F1 and F3 labels. 








Has caller provided an exit address to enable 
F1 label to be modified? 


No Yes 





4. Caller may modify F1 label 


unl 


Write new F1 label. 


l 
IKQWDSOO 


See Diagram FG. Write VTOC labels. 


Does code indicate successful write? CHECKERR 


¥ es ee 


Return uncorrectable error codes (4, 12, 16, 20, 


32, 36, 40, 56, 64) to 
panes 4 Return 


caller. 


Return 


Does error return indicate volume not mounted? 


Yes No 


¥ 


Mount volume. $$BOVSO1 
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Diagram FE2. Build VTOC Labels 





Module 
aac — —-- eee —> 10. Was volume mount successful? or label 
~ 
sea: ~Q No Yes > (\:) 
~— 
+ se. . 
Se “ 11. Does the operator wish to cancel the job? 
N 
\ No Yes ane 
Me parameter list 
N 12. Set cancel bit in DADSM $$BODADS 
* parameter list. 
N ‘ F | R15 
\ 13. Indicate failure to mount volume. 
\ bi eee 
\ E> Return 
RY 
14. Was there an overlap (error codes 24, 28)? 

Yes No Baa Return 
Parameter list 
+f ee ee ee ee ee Sx 15. Is DADSMSG bit on? 

Yes No o> Return 

Console 
16. Issue message identifying type of overlap 
condition to operator. operator 
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Diagram FE3. Build VTOC Labels 


Module 
or tabel 


Console 
Code from Does the operator wish to delete data set? 
operator es No 





18. Does operator wish to cancel the 
job? 


. No ss sae Return 


19. Set cancel bit in DADSM a  ) 
parameter‘tist, 
ets 


Return 


DADSM parameter list 


20. Erase overlapped data set. 
IKQSCROO 


See Diagram FD, Scratch VTOC Labels. 


21. Retry the request. ame: ) 
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Diagram FF1. Read VTOC Label 





















“Diagrams EG, EH, EN Module 

Parameter List 

ta —_--—* 1. Did caller specify volume checking bypass? IKQRDSOO 

= 

~. | tc Yes 

Sos ~ 
— inns a 
~ ~ > / 
2. Does the vol-ID in the 
DADCVHPL DLIST “se Volume Descriptor List 
fs na ae) Be a match the vol-ID in the 
- Pp . 
DADSM Parameter List? 
aes Let a] R15 
Bg Ns 
: ae’ Return 
Parameter List 
—F 3. Is this a read by address or read next request? 

DADRADDR “7 v ‘ie 

DADNEXT sig —— ! R15 

ames as pono Return | 

~ 
~N > 
4. Read VTOC label. 
LvToc—] IJJHCVHO 
Return 
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Diagram FGI. Write VTOC Labels 





Module 
“Diagrams EH, EN, FE 
Ril Parameter List 
DADSAREA 
1. Wasa disk address specified in the |/O area? 1KQWOSOO 
pate a me yes 
oe nae! 
2. ite in an 
ea FS i up to write in any ae 
: CVHRETA 
Parameter List eS ge tee 
ee eee 3. Set up to write to the address specified. CVHWADR 
DADCVHPL _— 
ee > 4. Write VTOC label(s). ee IJSHCVHO 





Return 
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Diagram FHI. Open and Close VTOC 


R1 


2.148 


Parameter List 


DADSVTOP |-—~ ~ 


VSE/VSAM VSAM Logic, Volume | 


>? 


R15 
Co —-—-— S| 3. Does the return code indicate an error? 






*Diagrams FB, FC, FD 


1. Is this a request to open the VTOC? 
Yes No 


Open the VTOC: 
2. Open the VTOC. 


DADCVHPL 















eee 
CVHSYSNO 


CVHOPEN 
CVHSHR 
CVHVOLID 





No Yes 





















4. ‘’ Was the error ‘‘no JIBs (extent 
blocks) available?” 


Yes No DRO 


y 


5. Issue error message. 


Sau Serco | 


Console 







Message to 
operator 









DADCVHPL 
6. Save the Volume Descriptor List address. ies tw 
Close the VTOC: 
ODADCVHPL 
7. Close the VTOC. ae) 


Return 


Module 


1KQVTCOO 


\JJHCVHO 
IKQVTCOO 


$$BODADS 


IJJHCVHO 
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Diagram GA1. CLOSE or TCLOSE: Disconnect a User’s Program from 


a VSAM Data Set 
























Automatic close 
(from supervisor 
terminator routine) 


User-issued 
TCLOSE 


User-issued 
CLOSE 


Search for an open ACB in the OAL. 











!s the OAL empty? 
f+ 
oe" | No Yes a Return 


Has a close for this ACB already been 
attempted? 


No Yes map) 


Pass this ACB to the VSAM CLOSE routine. 






OAL 
tace 
TACB 









SVC 2 issued 


Notes for Diagram GA1 


Note: When the user program issues a CLOSE or TCLOSE macro against 
an ACB or a DTF, or the user program SYNAD routine issues a 
CLOSE macro against an ACB, or the VSE end-of-job routines 
initiate an automatic close, an SVC 2 is generated. 


1. $$BACLOS is called by the supervisor during end-of-job processing 
to initiate automatic closing of ACBs that were not closed by the 
user’s program. 


2. If the OAL is empty or if automatic close has been disabled by 
using IKQVEDA, $$BACLOS exits to the supervisor terminator 
routine via SVC2 for $$BEQOJ4. 


3. A flag in the OAL entry indicates whether an attempt has already 
been made to close this ACB. If this is the case, the ACB is 
skipped, to avoid recurring attempts to close the same ACB, 
which would lead to a program loop. 


4, The ACB is passed to the close routine as an ACB list, containing 
only one ACB. 
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Module 


$$BACLOS 
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Diagram GA2, CLOSE or TCLOSE: Disconnect a User’s Program from 
a VSAM Data Set 














User-issued Module 


CLOSE 
(SVC 2 issued) 


VSE Close monitor 


» 5. Does the address in the list of ACBs and DTFs NonVSAM close: $$BCLOSE 


in an ACB? 
painters cB See VSE/Advanced Functions 
Yes No Diagnosis Reference: LIOCS 
Vol. 1: General Information and 


- 
-" 








Imperative Macros. 


SVC 2 issued 
VSAM interface processing CLOSE Work Area 


6. Initialize the Close Work Area. $$BCVSAM 


SVC11 issued (2 ) 








User-issued 
TCLOSE 
(SVC 2 issued) 


VSAM TCLOSE interface processing 









7. Does the address in the list of ACBs and DTFs 
point to an ACB? 


Yes No Return to user 
en a ORE 
CLOSE Work Area 


_ the Close Work Area. el 


SVC 17 issued 


$$BTCLOS 





Notes for Diagram GA2 


5. The VSE Close Monitor examines the DTF-type field (offset 20 
from the address passed in the list) of the ACB or DTF. If the byte 
indicates an ACB (X‘28’), an SVC 2 is issued and $$BCVSAM is 
fetched into the B-transient area. The list may consist of all DTFs, all 
ACBs, or a mixture. It is passed to the VSE Close Monitor by the user 
program via a pointer in register 0. 


6. The VSAM interface module obtains and initializes a work area in 
which it sets a flag to indicate a CLOSE macro was issued. Pointers 
are saved to the current list entry and the VSE communication region 
in the work area. It copies the user’s PSW and registers into the work 
area. It loads the VSAM Close module and then issues an SVC 11 to 
branch to it. 


7-8. (If the user program issued a TCLOSE (temporary close) macro against 
an ACB, the temporary close module is fetched into the B-transient 
area. 


The VSAM TCLOSE interface module examines the DTF-type field 
(offset 20 of the address passed in the list) of the ACB or DTF. If the 
byte indicates an ACB (X‘28’) and the ACB indicates that deferred 
write operations are not possible, this module obtains and initializes 
a work area in which it sets a flag to indicate a TCLOSE macro was 
issued. Pointers are saved to the current list entry, and the system 
communication region in the work area. It copies the user’s PSW and 
registers into the work area. It loads the VSAM Close module and 
then issues an SVC 11 to branch to it. 


2.150 VSE/VSAM VSAM Logic, Volume | Licensed Material — Property of IBM 


Diagram GA3. CLOSE or TCLOSE: Disconnect a User’s Program from 
a VSAM Data Set 


















Modul 
aes VSAM CLOSE processing: or label 
~ a — > 9. Is this an open ACB? Meare 
& — Yes No NNN 50) 
ACB oe eee — | (50) 
=i ae 
\ ~y 10. Connect the DSA. 
\ , 
11. Is this ACB for an AIX? 
pee | ‘\ (1°) 
eS Yer. oN (9) 
—— 
\ > 12. Has AIX processing been performed? 
“ Ne Mx No Yes 
_~ \ 
\ oi , 
“N <. \ Initiate AlX processing: Work Area 
IKOQCLOVY 


“ ‘\ 13. Save the request ACB. 
N | : 


| 14. Find the base cluster ACB. 







aes a 15. Does an upgrade set 
AMBUSB = ame exist? 





> 
| 4 No 
16. Find the first upgrade set member which 


is not the path entry and store its ACB 
as the current ACB. 


USB 
USBAIX 










17. Member found? 


No Yes 
Work Area ¥ 
ee 18. Store base cluster ACB as the current 
| [| _ Acs. | 
fea 


AIXBASE 





Notes for Diagram GA3 
9. The ACB identifier field is checked for an X‘AO’. The ACB open flag 


is also checked. If the ID is incorrectly specified or the open flag is 
off, an error code is set in the work area. 
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Diagram GA4. CLOSE or TCLOSE: Disconnect a User’s Program from 


a VSAM Data Set 


VSAM CLOSE processing (continued): 






































5 Module 
Complete outstanding 1/O: or label 
Work Area 
; RPL 
AMBL . Build an RPL. a IKQCLO 
teste = = 
oe ee 20. Issue an RCLOSE request and complete 
|AMBLPLHN > aus 
4! outstanding !/O operations (via record 
Fm management) for each PLH of the current 
PLH ye ACB. 
a If LSR is specified, issue a WRITEBUF macro 
bce} to write the buffers used by this ACB to disk. 
i= 22 aah 
Update catalog: Catalog 
AMDSB ARDB 
wy, 22. Set up the catalog parameter list and IKQCLCAT 
-~ ] | field parameter list. 
“A 
Cd / See Diagram DG1, UPDATE: Call the catalog CLALTER 
/ UPDATE function. 
7 23. Does the return code from the UPDATE 
/ 4 function indicate that the catalog entry 
= 1} information had been changed since the data 
7 ¢ | set was opened? 
7M. 
Catalog ae Yes No 
a ly 
/ 4 24. See Diagram DE1, LOCATE: Call the catalog CLLOCATE 
/ LOCATE function. 
v) 
R15 /, _— @: 25. Does the return code from LOCATE indicate 
[ti = that newer information has been found? : 
/ sf Lock File 
/ No Yes 
Work Area a 
Unlock the file: 
26. Is the close temporary? Lock Table 
27. Unlock file for this component. il OPNWA 
28. Processed both data and index? ee 
Yes No p> (22) | 
Notes for Diagram GA4 (29) 
Description Module Routine Description Module Routine 
19. BUFMGT issues an RCLOSE to IKQCLO BUFMGT 1/O requests. All current read oper- 
!KQVSM for each string. Dummy IKQVSM ations are finished and all pending up- 
RPLs are built and passed by date or write operations are done. If 
BUFMGT to IKQVSM, which then an error occurs while !/O is being 
passes control to |KQRCLOO. completed, |KOQVSM returns a 
If load mode with speed optionhas !KQRCLOO nonzero error code in register 15, and 


2.152 


been specified by the user's program |!KOQPFOOO 

(which means that a control interval 

is written to the disk only when the 22. 
control interval has been filled with 

logical records), the remainder of the 

control area must be formatted and an 23 
SEOF record (all Os) placed at the end , 
of the area. 


For a key-range data set, IKQCISOO {KQCISOO 


formats all remaining unformatted key 23-24. 


ranges. 


Note: In recovery mode, each control 
area is formatted with empty control 
intervals, and the control area is 
terminated with an SEOF prior to 
loading any records into the control 
area. Hence, in this case, it is not 
necessary to call |KQPFOOO. 


{KQBFA0O0 is always entered from 
IKORCLOO to complete outstanding 


!KQBFAOO 


VSE/VSAM VSAM Logic, Volume ! 


BUFMGT sets an error code in the 
work area, 


If RO=0, IKQCLCAT has been called IKQCLCAT 
by Close; if RO=4, is has been called 
by Record Management. 


To update the permanent data set 
information in the catalog, Close 
utilizes the work area for the catalog 
parameter and field parameter lists. 


(KQCLCAT CLCATLG 
CLALTER 


IKQCLCAT CLCATLG 
CLLOCATE 


If the information in the catalog 
entry had been changed since the 
data set had been opened (that is, 
between Open and Close another user 
had processed the data set and infor- 
mation had been altered), the latest 
copy of the entry must be located. 

If the data set has an index, repeat 
steps 22-28 for the index. 
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Diagram GAS. CLOSE or TCLOSE: Disconnect a User’s Program from 
a VSAM Data Set 









Module 
VSAM close processing (continued): or label 
Work 
ones SS ns ee 29. Is the close temporary? IKOCLO 
No Yes > (43) 
30. Doclose disposition processing on the 
file. 
Release resources for close: 
COMREG 


—_ — > 31. Was the DASD file protection option specified? 


eure: | | y No 


Extent block table 


Supervisor 












Free entry list Extent block table 
























> 32. Load IKOVJIBS and branch to the Co Cd 
routine to free the JIBs (extent blocks). 
Volume list | | {KQJIBSM 
33, - If the current ACB is the requestors ACB, IKOASNMT 
unassign any dynamically assigned symbolic 
units, 
ACB 
ir bo eel _ ew 34. If LSR is not specified, free the buffers and 1KQCLO 
ACBLSR - the channel program area. RELSCORE 
va) | 35. Is the current ACB the request ACB? 
77 
4 Yes No >(37) 
Work area J v 
ACBREO ye 36. Free the whole allocation chain for 
WEEE this ACB. 
~BCURR 
37. Free allocation units which do not contain ACB 
external control blocks (ACB, RPLs). a 
38. Reset external control blocks. (=0) 
(=0) 
(0) 
‘fod? 
(a 39. Is LSR specified? loff} 
Yes No are 
Notes for Diagram GAS 
Description Module Routine Description Module Routine 
29. A temporary Close does not release 34. Storage obtained by Open and/or end - 
the JIB extents. of-volume for LPMBs (other than the 
first LPMB), EDBs (other than the first 
30. DISP= KEEP (specified explicitly or IKOCLRDD EDB), ARDBs, BCBs, and buffers is 
defaulted) or DISP = DATE when the released. If the data set has an index, 
file is not expired require no action. this step processes the index also. 
Otherwise, delete processing is done 
depending on file characteristics: 35-37. Allocation units containing the user’s 
@ NOALLOCATION files > Release  IKQCLRDD RELEASE external control blocks may not be 


released. The whole allocation chain 


extents . : : 
; may be released if the first allocation 
See Diagram DM; Release Extents unit contains only internal control 
® Implicit define files > Implicit IKQOCIMR blocks (AMBL allocation chain) or if 
delete the external control blocks were created 
, : by OPEN (base cluster ACB, de set 
@ Other reusable files > Reset file IKQCLRDD ena oe ea ae 
to empty 


32. If the DASD file-protection option 
has been specified, the extent blocks 
for each extent of the data set are 
freed. The IKQJIBSM routine is 
called to release the extents. This 
processing is repeated for all extents. 
{f the data set has an index, this step 
processes the index also. 
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Diagram GA6. CLOSE or TCLOSE: Disconnect a User’s Program from — 


a VSAM Data Set 


VSAM CLOSE processing (continued): 









Release resources (continued): 








Load and seize control of the VSAM 
Shared Resource Table (VSRT). 






esate Teams 
VSRTUCNT 
ere! 







41. Decrement the resource pool use count. 


42, Release control of the VSAM Shared 


Work area Resource Table. 


AIXATTR 


AIXUPGRD 
AIXBASE Is an alternate index being processed? 


AIXENTRY 





Yes No 


ACBREQ 
ACBCURR 


Has the request ACB been handied? 
Yes No 


45. Reset AIX indicator. os 1) sete 
+> 46. Was the current ACB a member of the aaah 
upgrade set? 


AiXCURR 













Yes No 







USBAIX 


USBACB ; 


47. Search for next upgrade set member 
which is not the path entry. 


48. Was another member found? 
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Module 
or label 


IKQCLOCL 


Diagram GA7. CLOSE or TCLOSE: Disconnect a User’s Program from 


a VSAM Data Set 


VSAM CLOSE processing (continued): 


Switch to next cluster (continued): 


Work area 


~ 49. Store base cluster ACB as the current 
ACB. 


50. Store the path ACB as the current ACB. 





51. Is this a temporary close? 


No Yes me 53) 
OAL ¥ 
Ss 282. Upaate the OAL. 


Work area ‘53. Move return code into R15 and error 
| code into the ACB. 


List 


tacs. > 54. Is there another entry in the list of ACBs 
oo ape! 
OTF ‘\ 
N SVC2 issued 


XN , 
Common exit 
‘XN 
‘ per + NG $$BCVS02 
» 9 
isvc2 | | 55. _ Is entry an ACB or a DTF? 
ACB DIF 


Return to VSE close 
monitor via FETCH (SVC 2) 





Notes for Diagram GA7 


52, The OAL entry for this data set is set “inactive” and the count of 
open ACBs in the OAL is decremented. 


63. The work area error code field is checked, and the error return code 
is moved into the ACB error flag field. An error indicator is also set 
in register 15 of the user's register save area. 


54, If there are no more entries in the tist, control is passed to 
$$BCVSO2, the VSAM common exit module, via an SVC 2. 


§5. Fora normal (user-issued) CLOSE or TCLOSE, $$BCVS02 returns 
control to the user. For an automatic close, it returns control to 
S$$BACLOS. 
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Work area 


AIXCURR 


AIXENTRY 


Section 2. Method of Operation 


Module 
or label 


IKQCLO 
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Module Prologues 


Section 3. Program Organization 


VSAM program listings are the key to VSAM’s organization. You get into 
the listings from the method of operation diagrams. Once you have located 
the module or routine name that interests you in the diagrams, you are 
ready to turn to the listing to find the additional information you require. 


Each VSAM module listing begins with a description of the module, called 
the module prologue. The information contained in VSAM prologues is 
described in the topics that follow. 


Module name: The external procedure name of the module (for example, 
IKQOPN). 

Descriptive name: The English name of the module (for example, VSAM 
Open). 


Status: The version and release level of the module. 


Function: A brief step-by-step explanation of the functions performed by 
this module. Function is divided into steps so that you may more easily 
locate the routine responsible for each step. 


Notes: A generalized heading that includes (1) any dependencies, for exam- 
ple, CPU model or features, that will affect the operation of this module, (2) 
any restrictions that apply to this module, (3) symbols used to represent 
registers and register usage, (4) symbolic name of the maintenance area for 
this module and whether the maintenance area is used or reserved, and (5) 
any special terms and acronyms that are used within this module that are 
not necessarily used elsewhere in the documentation. 


Module Type: A description of the type of this module (for example, proce- 
dure or macro) the name of the compiler used/required to create this mo- 
dule, the amount of storage required by this module for executable code and 
associated data, and the attributes of the module (for example, reentrant or 
read-only). 


Entry point: The name of the point at which control can enter this module, 
the conditions of entry, the calling sequence by which control was given, 
including any parameters passed and the names of modules that may enter 
at this entry point. 


Input: A description of anything this module gets or references, such as 
registers, control blocks, or data. The means by which this module gains 
access to the input is included. 

Output: A description of registers, control blocks, and data areas at output; 
any messages issued as a result of this module’s processing are included. 
Exit-normal: A description of conditions at and reasons for normal exit from 
this module, including the names of modules called by this module. 


Exit-error: A description of conditions at and reasons for any error exit from 
this module. 


External references: A list of modules, data areas, etc., defined outside of or 
accessible outside of this module. 


Tables: A list of all local tables and work areas, that is, data areas built and 
used only within this module. 


Macros: A description of system macros used by this module. 
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Routine Prologues 


Change activity: A list of any change activity to this module. 


The numbered steps in the module prologue FUNCTION heading are your 
link to the routine prologues. Routine prologues contain (1) an expanded 
description of the processing steps shown in the module prologues, (2) input 
to the routine, and (3) output from the routine. 


Program Structures and Catalog Program Flowcharts 


The following group of program structures and, for the catalog modules, 
program flowcharts, shows how the VSAM program is organized. These 
structures link modules together from the time a macro instruction is issued 
by the user program to the time that control exits from VSAM. The struc- 
tures are ordered by user-issued macro instructions and the verify function 
in a way similar to the organization of method of operation diagrams. In 
addition, program structures are also shown for significant subfunctions 
required to complete processing of a macro instruction. The subfunctions 
included in this volume are the ISAM interface, open/close, catalog man- 
agement, and DADSM. 


The flowcharts are arranged in alphabetical order according to the last two 
alphameric characters of the module name. The title of the flowchart also 
has a number, in the third position, which is the page number within the 
flowchart. Module IGGOCLAF is thus shown on two pages — Chart AF] 
and Chart AF2. Off-page connectors between the pages contain the page 
number and the block location. For example, the off-page connector at 
block CI in chart AF1 contains “02 J1”, which refers to block J1 on chart 
AF2. As the flowcharts are intended to show the calling sequence rather 
than the internal logic, not all procedures are documented. Only those 
procedures which call other procedures are shown. This leads to two differ- 
ent types of cross-references in the flowcharts. Look, for example, at Chart 
AF2, blocks H1 and H2. In H1, the procedure IGGPF4WR is called, with 
the cross-reference BU1A2. This means that the procedure is located in 
module IGGOCLBU and documented in Chart BU1, starting at block A2. 
In H2, in contrast, the cross-reference for procedure IGGPDLER is simply 
AF. This means that the procedure is located in module IGGOCLAF, but is 
not documented. 


Figure 3.1 shows the symbols used on the structures and describes their 
meanings. 


indicates that a module is called and returns to calling module 
Indicates that a module does not return to calling module 


Indicates that a module is called under certain conditions and then 
returns to calling module 


Indicates that a module is called under certain conditions and does 


not return to calling module 


UPPER CASE Indicates that a module is executed and calls one or more modules 
before returning 


lower case Indicates that a module is executed and then returns to the calling 
module 





Figure 3.1 Graphic symbols used in program structures 


3.2 VSE/VSAM VSAM Logic, Volume | Licensed Material — Property of IBM 


Wa] JO Ayadoig — jelsayeWW pesusdly 


UONeZIURZIO WeRIZOIg "¢ UOII9Eg 


Ce 


v€ aunaiy 


SOIIVU UONE[NGUCUL YIO]q [01}U0d SS9d0Id 0} 31NJINI)S WLIO 


GENCB 
macro 


1KQGEN 
generate a 
control block 


MODCB, SHOWCB, 
and TESTCB macros 


Can cael 


r 


1 
Further 
diagnosis 
required 

1 

t 

i] 

i] 
1KQTMSD 
modify, display, 
or testa 
contro! block 


Bey 
t 


Diagnosis 
done by 
macro 
1 
8 
| 
| 
IKQTMSF 
modify, display, 
or test a 
control block 


BLDVRP 
macro 


!IKQBRP 

build a 

VSAM resource 
pool 


DELVRP 
macro 


IKODRP 

delete a ; 
VSAM resource 
pool 
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$S$BOPEN $$BOPEN1 $$BOVSAM 
OPEN macro ——* VSE OPEN =? VSE OPEN ——* OPEN 
MONITOR MONITOR INTERFACE 


IKQOPN 
VSAM OPEN 
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IKQLAB 1KQOPNUC IKQOPNA! IKOQOPNUS 
look at Process CAT Open Open 
label Parameter in alternate upgrade 
area DLBL statement Te set , 
es IKOSTM 
i 71! Storage 
1 Manager 
IKQOPNCT IKQLAB 13 
OPEN look at IKQOPNHC IGGOCLC9 
CATALOG label LOCATE catalog 
area DATA SET management 
INFORMATION (see Figure 3.5) 
IN CATALOG 
IKQJIBSM cia eset eas nes ~yybCStcro- crn 
UPDATE EXTENT F&F f= ami : 
BLOCKS FOR \ (reusable Cl Locate i 
EDB CHAIN t data set) i | 
IKQOCMSG 1 IGGOCLC9 ; { 
message J CATALOG i t 
writer i MANAGEMENT 1 1 
' (see Figure 3.5) 1 | 
IKQOPNRD IKQOCSHR J IKOOPNAB 
Reset file sharing ! build AMDSB 
reusable module I control blocks 
data set (dynamic 
data set) 
IKQSTM 
\ storage manager 
IGGOCLC9 IKQOCSHR IKQOPNDS 
catalog file sharing dynamic space 
manage - module allocation 
ment 
IGGOCLAY IGGOCLAV {GGOCLCB 
(IGGPSCNC) (IGGPUPD) (IGGPRELE) 


scan CPL update release 


(proper 
volume) 
(see Figure 
3.3, Part 2 


of 3) 


IKQOPNRP 
Attach 
Resource 


Poo! 


1KQOPNNC ! 
Process ' t 
next ; ' 
cluster ! : 
; IKQOPNDO ’ $$BCVS02 
i CLEANUP ' common 
1 AFTER OPEN 5 exit 
1 FAILURE : 
4 
teoet bt 
IKQSTM 4 IKQOCMSG 
Storage § a ‘Message 
Manager ! : Writer 
i} 
r 71 
IKQOCSHR IKQJIBSM 
file sharing RELEASE 
module EXTENT BLOCKS 
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From Figure 3.3 
(Part 1 of 3) 


{KQOPNOV 
OPEN 
VOLUME 
EXTENT 
ae on 





pee e ad hee 


IKOQOPNPV IGGOCLC9 IKQSTM 
Open volume catalog storage 
sort management manager 


IKQJIBSM 
UPDATE EXTENT 
BLOCKS FOR 
EDB CHAIN 


ee eee eee 


tKOASNMT 
Automatic assign- 
ment volume 
| 
! 

| 

1 
Call volume 


mounting routine 
(See Figure 3.8) 


L--~---—--, 


i 
I1KOMTMSG 
VSAM OPEN 
mount message 
writer 


of 
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IKQLAB reads the label area and establishes the 
connection between data set name and file name. 


IKQOPNCT is called if a catalog or a catalog recovery 
area is to be opened. IKQOPNCT finds in VTOC the 
address of the catalog cluster record or the CRA cluster 
record and reads it. 


IKQOPNCT checks if a user catalog is needed to open 
the cluster. It obtains user catalog label information 
via IKQLAB if required. 


IKQOPNHC is called to locate information in the catalog 
concerning the cluster to be opened. It resets reusable 
data sets via IKQOPNRD. !t checks whether the cluster 
can be opened according to the sharing conditions via 
IKQLASMD. 


IKQOPNATI is called if the cluster to be opened is an 
alternate index cluster. IKQOPNAI retrieves the cluster 
record of the base cluster identified by the AlX record 
from catalog. 


IKQOPNUS is cailed whenever a possbile base cluster is 
processed. IKQOPNUS retrieves information concerning 
the upgrade set from the catalog. 


tKQSTM is called to allocate VSAM record management 
control blocks. 


G® ©O®D O©O®© 


IKQOPNAB is called to do validity checking and build 
the AMDSB contro! block structure for a single component. 


1KQOPNOV is called to process the cluster’s extent 
information. It retrieves the extent information from the 
catalog, obtains extent blocks via IKQJIBSM, checks if the 
proper volumes are mounted, and builds the control blocks 
via IKQSTM. 


IKQOPNRP is called when resource sharing is requested. 
It attaches the cluster’s control block structure to the 
resource pool. 


IKQOPNNC is called when an alternate index structure is 
to be opened. It decides which cluster is to be opened 
next and creates ACB and RPL via |KOQSTM. 


IKQOPNDO is called whenever an open error occurred. 
It reduces the open count via IKQLASMD. It resets the 
open indication in catalog. It releases the extent blocks 
via IKQJIBSM. It frees the allocated storage via IKOSTM. 


IKOQOCMSG is called whenever a message has to be written. 


$$BCVSO02 returns-control to the user. 
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{ (SVC 11) 
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1I1PCLSOO 
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$$BOPEN2 i t 
READ INTERFACE pom creed | bee ne ee ey 
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(error) (error) 
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$$BSETL 
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ISAM SETL 
PROCESSOR 


IIPPRCPR 
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PROCESSOR 
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r--- 
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(error) 


HIPPRCMR User's 
processor program 


(messages) 


SETFE macro- 


; 


S$BSETFL 
VSE 

ISAM SETFL 
PROCESSOR 


IIPPRCPR 
ISAM 
INTERFACE 
PROCESSOR 


i] 
r--4 
t 


(error) 


{tiPPRCMR User's 
processor program 


(messages) 


ENDFL macro 


| 


$$BENDFL 
VSE 

ISAM ENDFL 
PROCESSOR 
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HIPPRCPR 
ISAM 
INTERFACE 
PROCESSOR 
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' 


(error) 
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processor program 
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IGGOCLAC 
MASTER 
CATALOG 
SEARCH 
(IGGPMCO) 

1 

1 

1 

(catalog 
not open) 

i 

] 

i 
1GGOCLAD 
MASTER 
CATALOG 
OPEN 
(IGGPMCO2) 


SSBOPEN 

VSE OPEN 
MONITOR 
(see Figure 3.3) 


(ALTER 
DEFINE 
DELETE 
LISTCAT) 


tGGOCLAT 
CMS DRIVER 
(IGGPCDVR) 
(see Figure 3.5 
Part 2 of 2, 
and Chart AT) 


IGGOCLAY 
scan CPL 
(IGGPSCNC) 


1 
(CRA not open) 


IGGOCLCO 
open CRA 





IGGOCLAB 
CATALOG 
DRIVER 
(1GGPACDV) 


(UPDATE 
LOCATE) 


1GGOCLAH 
SEARCH/OPEN 
CATALOG 
(tGGPSCAT) 





IGGOCLAG 
catalog 1/O 
subfunctions 
({GGPGET) 


1GGOCLCG 
Do 1/O 
[| 


-—— SJ t.. 


LOCATE, UPDATE, ALTER, 
DEFINE, DELETE, LISTCAT 


(see Chart AZ) 


ae 
(error) 


‘ 
{GGOCLAF 
DELETE 
CATALOG 
(IGGPEMSG) 
{IGGPEMIO) 
(see Chart AF) 


requests 
!tGGOCLC9 
CATALOG 
FIRST LOAD 
i 
a 
rec erere 
8 t 
(no build (checkpoint 
request) CCR required) 
IGGOCLAG IGGOCLAG 
catalog !/O catalog 1/O 
subfunctions subfunctions 
{(IGGPRCCR) (IGGPCCCR) 
oe er ee ee Se es ee ees es ee es, 
r--- 
| 
§ 
(UPDATE) 
--4 l 
| 
IGGOCLBM IGGOCLAV 
CHECK MODIFY 
AUTHORI- CATALOG 
ZATION FIELD 
(IGGPCKAU) (tGGPUPD) 
(see Chart AV) 
IGGOCLAZ IKQDCN 
EXTRACT DTF 
CATALOG console 
FIELD file 
(1{GGPEXT) 


I1GGOCLAH 
search 
catalog 
(IGGPRPLF) 
7 
caer! eaerome ame ten hs + 
1 
| 
(LOCATE) 
|tGGOCLAZ 
EXTRACT 
CATALOG 
FIELD 
(1GGPLOC) 
IGGOCLAY {GGOCLBA iGGOCLBS 
scan CPL TESTS VOLUME 
(IGGPSCNC)  (IGGPTSTS) ENTRY 
(IGGPGVAL) TRANSLATION 
(I1GGPGREC) (tGGPXEXT) 


(see Chart BA) (see Chart BS) 
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IGGOCLAT 
J 


CMS DRIVER 
(1GGPCDVR) 
1 
Cree SS SS Se SS SS SS ae bee pe em em me ee re mre r ero a 
! 1 ' 
DEFINE : DELETE 
i i 
iaeee seals tar eSs aa Se 4 egies | anna Gi | eaoahads Gasecinceies| 
I | 1 | ! ' ! ] ! ! ! i 
SPACE CATALOG Alternate Path NonVSAM not not ALTER LISTCAT = Cluster Catalog Space 
1 or index ' : DEFINE  LISTCAT ' ’ Alternate Index 1 
1 CLUSTER i ' space ; : Path 
' ; 1 1 1 , ! NonVSAM i I 
i i ! : 1 ! ' ! l ' ' ! 
’ , | 1 1 ' i ' ' l 1 
1 ! 1 ' 1 ' 1 1 1 ' i 1 
! y ! ! ' ' 1 t ! 1 ' 
IGGOCLAQ IGGOCLCA IGGOCLBH ! IGGOCLBM |GGOCLBQ IGGOCLAF 
CATALOG i DEFINE DEFINE ’ CHECK \ LISTCAT I DELETE ' 
DEFINE , ALTERNATE I NONVSAM j AUTHORI- ' (I1GGPLSTC) : CATALOG t 
SPACE INDEX I DATA SET ’ ZATION , (see Chart BO) (1GGPDELC) ’ 
(IGGPDEFS) ' (see Chart CA) ’ (IGGPDEFA) ! (IGGPCKAU) ' : (see Chart AF) 1 
(see Chart AQ) I 1 (see Chart BH) (see Chart BM) ' 1 
: 1 ! ! 1 
I ' I ' ' ! 
IGGOCLAL IGGOCLCP IGGOCLAH 1GGOCLBD IGGOCLBG IGGOCLBL 
CMS DEFINE DEFINE SEARCH CATALOG DELETE DELETE 
ist MODULE PATH CATALOG ALTER (IGGPDEL) SPACE 
(1GGPDEF) (see Chart CP) (1GGPSCAT) PROCESSING (see Chart BG) (IGGPDELS) 
(see Chart AL) (see Chart AH) (IGGPALT) (see Chart BL) 


(see Chart BD) 
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$IJJHCVH 
open VTOC 


IKOALLOO 
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IKQVTCOO IKOLAB 
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eee te oe “| 
r 7 
' | 
1 (error-volume {close) 
; not mounted) 
$$BODADS $$BOVSO01 $IJJHCVH 
START OF CATALOG/DADSM close VTOC 
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S$BOMSG1 $$BOMSG1 
VSE VSE 
MESSAGE MESSAGE 
WRITER WRITER 
VSE exit $S$BOPEN1 
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(see Figure 3.6 
Part 2 of 2) 
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(operator option to 
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CLOSE macro TCLOSE macro 
AUTOMATIC | 
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(from Supervisor $$BCLOSE $$BTCLOS 
Terminator Routine) VSE CLOSE TCLOSE 

| MONITOR : INTERFACE 
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CLOSE 
INTERFACE 
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IKQCLOVY IKQVSM | 
initialize REQUEST | , 
AIX CLOSE DRIVER { ' 
(See Vol. 2) 
| | 
IKQCLCAT IKQJIBSM | ! 
Close catalog UPDATE EXTENT | 1 
interface function BLOCKS FOR ' ! 
EDB CHAIN \ 
| 1KOQSTM ! IKQOCMSG 
) storage I message 
' manager writer 
IKQOCSHR 1 
» : IKQCLOCL BCVSO02 
File Sharing {KOASNMT close AIX jaca 
module Unassign dynamic exik 
symbolic units 
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Close disposition 
processing 
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' 5 
r-- pas | Loc. 4 
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File Sharing Catalog Management 
module to reset file 
(See Fig. 3-5) 
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IKQCLOVY is called if an alternate index structure 
is to be closed: i.e. a path entry or an upgrade set 
exists. IKQCLOVY determines which cluster is to 
be closed first. 


IKOQVSM is called to complete outstanding 1/O. For 
LSR (loca! shared resources) deferred |/O is completed. 


IKQCLCAT is called to update the high water marks 


and the statistics for the data set to be closed in catalog. 


IKOJIBSM is called to delete Extent Blocks. 


IKQASNMT is called to unassign. Dynamic assign- 
ment occurred if a symbolic unit was not specified 
on the EXTENT statement. 
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1KOSTM is called for CLOSE request to free the 
virtual storage occupied by the contro! blocks of the 
data set to be closed. 


IKQCLOCL is called if an alternate index structure is 
to be closed. IKQCLOCL determines the next cluster 
to be closed. 


{KQOCMSG is called whenever an error turns up 
during close. IKQOCMSG writes a message to the 
user. 
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IJIGVM10 


From Figure 3.3 

(Part 2 of 3) and 
Figure 3.6 (Part 1 of 2 
and Part 2 of 2) 
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Section 4. Directory 


This section contains the following cross-reference material: 


VSAM Phase-to-Module Index 
IIP Phase-to-Module Index 
Component Index 

Module Directory 

Routine Directory 

Catalog External Entry Points 
Data Area Directory 


VSAM Phase-to-Module Index. 
The core image library contains the VSAM phases. Their names are identi- 
| fiable by IKQV,$S, or $$B. Packaged within the phases are the VSAM 
modules, identifiable by the leading characters IKQ, IGGO, $8 or $$B. Two 
service aid phases, IKQVDU and IKQVEDA are not included in the link- 
edit of VSAM and must be placed in the core image library by executing a 
job described in Service Aids. 


The following list includes the phase names and the names of the modules 
included within each phase. 
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Phase name 
IKQFTIND 


IKQVASMT 


IKQVBRP 
IKQVCAT 


IKQVCLC 
IKQVCLIF 
IKQVCLOC 
IKQCLOS 
IKQVCLOV 
IKQVDCN 
IKQVONT 
IKQVDRP 
IKQVDTPE 
IKQVDU 
IKQVDUMP 


IKQVEDA 
IKQVEDX 
IKQVEOV 
IKQVGEN 
IKQVJIBS 
IKQVLAB 
IKQVCLRD 
IKQVMSG 
IKQVNEX 
IKQVOPEN 


IKQVPBF 
IKQVRBA 
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Module name(s) 


IKQFTIND 
IKQFT1 
IKQFT2 
IKQFT3 
IKQASNMT 
IKQMTMSG 
IKQBRP 
IGGOCLAB 
IGGOCLAC 
IGGOCLAD 
IGGOCLAE 
IGGOCLAF 
IGGOCLAG 
IGGOCLAH 
IGGOCLAJ 
IGGOCLAK 
IGGOCLAL 
IGGOCLAN 
IGGOCLAP 
IGGOCLAQ 
IGGOCLAR 
IGGOCLAS 
IGGOCLAT 
IGGOCLAU 
IGGOCLAV 
IGGOCLAW 


IKQCLCAT 
IKQCLIF 
IKQCLOCL 
IKQCLO 
IKQCLOVY 
IKQDCN 
IKQDNT 
IKQDRP 
IKQVDTPE 
IKQVDU 


IKQDUMP 
IKQDUMPC 


IKQVEDA 
IKQEDX 
IKQEOV 
IKQGEN 
IKQJIBSM 
IKQLAB 
IKQCLROD 
IKQOCMSG 
IKQNEX 


IKQOPN 
IKQOPNAB 
IKQOPNAI 
IKQOPNCT 
IKQOPNDO 
IKQOPNDS 
IKQOPNHC 


IKQPBFOO 
IKQRBA 


IGGOCLAX 
IGGOCLAY 
IGGOCLAZ 
IGGOCLA6 
IGGOCLA7 
IGGOCLA8 
IGGOCLBA 
IGGOCLBB 
IGGOCLBC 
IGGOCLBD 
IGGOCLBE 
IGGOCLBF 
IGGOCLBG 
IGGOCLBH 
IGGOCLBL 
IGGOCLBM 
IGGOCLBN 
IGGOCLBQ 
IGGOCLBR 


IKQOPNNC 
IKQOPNOV 
IKQOPNPV 
IKQOPNRD 
IKQOPNRP 
IKQOPNUC 
IKQOPNUS 


IGGOCLBS 
IGGOCLBT 
IGGOCLBU 
IGGOCLBW 
IGGOCLBX 
IGGOCLBY 
IGGOCLB8 
IGGOCLCA 
IGGOCLCB 
IGGOCLCD 
IGGOCLCG 
IGGOCLCL 
IGGOCLCO 
IGGOCLCP 
IGGOCLCR 
IGGOCLCS 
IGGOCLCX 
IGGOCLCY 
IGGOCLC9 


VSAM phase-to-module index (part 1 of 2) 


Licensed Material —- Property of IBM 


IGGOCLEG 
IGGOCLES 
IGGOCLET 
IGGOCLEX 
IGGOCLEZ 
IGGOCLFA 
IGGOCLFB 
IGGOCLFC 
IGGOCLFD 
IGGOCLFE 
IGGOCLFF 
IGGOCLFH 
IGGOCLFQ 
IKQALLOO 
IKQPOPOO 
IKQRDSOO 
IKQRENOO 
IKQSCROO 
IKQVTCOO 
IKQWDSOO 





Phase name Module name(s) 


IKQVRM 


IKQVRT 
IKQVSCAT 
IKQVSHR 
IKQVSTM 
IKQVTMS 


$SVAVSAM 
$$BACLOS 
$SBCLCRA 
$$BCVSAM 
$$BCVS02 
$$BCVSO3 
$$BCVS04 
$SBODADE 
$$BODADS 
$$BOVSAM 
$$BOVSO1 
$$BTCLOS 


Figure 4.1 


IIP Phase-to-Module Index 


IKQAIX 
IKQBFAOO 
IKQBFBOO 
IKQBFCOO 
IKQBFD 
IKQBLD 
IKQCASOO 
IKQCIL 
IKQCIR 
IKQCISOO 
IKQCIU 
IKQDDR 
IKQERH 


IKQVRT 
IKQSCAT 
IKQOCSHR 
IKQSTM 


IKQTMSD 
IKQTMSF 


$SVAVSAM 
$$BACLOS 
$$BCLCRA 
$$BCVSAM 
$$BCVS02 
$$BCVSO03 
$$BCVS04 
$$BODADE 
$$BODADS 
$$BOVSAM 
$$BOVS01 
$$BTCLOS 


IKQERX 
IKQGCI 
IKQGNX00 
IKQGPT 
IKQINT 
IKQIOA 
IKQIOB 
IKQIOC 
IKQIOD 
IKQIXE0O 
IKQIXFOO 
IKQIXSOO 
IKQJURN 


IKQKRD 
IKQLCD 
IKQLCN 
IKQLCP 
IKQLNA 
IKQMDY 
IKQNCAOO 
IKQPFOOO 
IKQRCLOO 
IKQRQA 
IKQRQB 
IKQRQC 
IKQRRP 
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IKQRTV 
IKQSCN 
IKQSFT 
IKQSPMOO 
IKQSRG 
IKQSRT 
IKQSRU 
IKQUPD 
IKQUPG 
IKQVFY 
IKQVSM 


The core image library contains the ISAM Interface Program phases, 
_ identifiable by the first three characters IIP or $$B. Packaged within the 
phases are the IIP modules. The following list includes the phase names and 


the names of the modules included within each phase. 


Phase name Module name(s) 


$$BOCISC 
INPCLOSE 


IIPOPEN 
1IPPROC 


IIPAMDTF 


Figure 4.2 
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IIPBMROO 
liPCLSOO 
liPOPNOO 


lIPPRCPR 
IIPPRCMR 


IIPAMTOO 


IIP phase-to-module index 
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Component Index 
VSAM is logically grouped into components, each of which consists of 
several modules. This index (Figure 4.3) lists these components in the 
following order: catalog, control block manipulation, open/close/EOV, 
DADSM, ISAM interface, and service aids. 

Module function 


Component Module name 


Catalog 


IGGOCLAB 

IGGOCLAC! 
IGGOCLAD! 
IGGOCLAE2 


IGGOCLAF 
IGGOCLAG 
IGGOCLAH 
IGGOCLAy3 
IGGOCLAK3 


IGGOCLAL4 
IGGOCLAN4 


IGGOCLAP4 


IGGOCLAQS 
IGGOCLAR®6 
IGGOCLAS2 


IGGOCLAT 


IGGOCLAUS 
IGGOCLAV? 
IGGOCLAW7 
IGGOCLAX7 
IGGOCLAY78 
IGGOCLAZ8 
IGGOCLA6S 
IGGOCLA79 


Act as switching station for various catalog routines 
Check whether VSAM master catalog is open 

Open VSAM master catalog 

Open and create VSAM catalog and write self- 
describing catalog records 

Delete VSAM catalog 

Perform VSAM catalog |/O subfunctions, part 1 
Search VSAM catalog for required entry 

Build data and index entries and allocate space 
Build data and index entries and construct fields in 
records 

Perform general Define processing 

Perform Define processing and construct cluster 
entry 

Perform Define processing and check AMDSBs, 
volume lists, and space parameters 

Define VSAM data space 

Initialize for VSAM space suballocation 

Define catalog, allocate physical space, and initialize 
preliminary records 

Act as Access Method Services request dispatcher to 
catalog functions 

Suballocate VSAM space 

Modify VSAM catalog fields 

Add new VSAM catalog fields 

Alter VSAM catalog fields 

Initialize and scan catalog parameter list 

Extract VSAM catalog fields 

Define VSAM space 

Delete an entry from catalog and, if a unique data set 
on more than one volume, mount other volume and 
delete an entry from catalog for that volume 


IGGOCLAC and IGGOCLAD are related master catalog open processing modules. 
IGGOCLAE, iGGOCLAS, and IGGOCLES are related Define (catalog build and open) 


modules. 


IGGOCLAJ, IGGOCLAK, and IGGOCLA8 are related Define modules. 

IGGOCLAL, IGGOCLAN, IGGOCLAP, IGGOCLBX, IGGOCLBY, and IGGOCLEX are 
related modules commonly known as the Define routine. 

IGGOCLAQ and IGGOCLAG are related Define space modules. 

IGGOCLAR and IGGOCLAU are related space suballocation modules. 
IGGOCLAV, IGGOCLAY, IGGOCLBA, IGGOCLAW, IGGOCLAX, IGGOCLBW, 
IGGOCLBT and IGGOCLBS are related modules commonly known as the Modify 


routine. 


IGGOCLAZ, IGGOCLAY, IGGOCLBA, and IGGOCLEZ are related modules commonly 


known as the Extract routine. 


IGGOCLBG, IGGOCLA7 and IGGOCLCX are related delete catalog entry modules. 
IGGOCLBD, IGGOCLBE, IGGOCLBN, and IGGOCLCD are related Alter processing 


modules. 
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Component 


Catalog 


CB Manip. 


Figure 4.3 
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Module name. 


IGGOCLA83 


IGGOCLBA7:8 
IGGOCLBB? 
IGGOCLBC9 
IGGOCLBD!10 


IGGOCLBE!0 


IGGOCLBF 
IGGOCLBG? 
IGGOCLBH 
IGGOCLBL 


IGGOCLBM 
IGGOCLBN!0 


IGGOCLBQ 
IGGOCLBR 


IGGOCLBS7 
IGGOCLBT7 
IGGOCLBU 
IGGOCLBW7 
IGGOCLBX4 
IGGOCLBY4 
IGGOCLB8 


IGGOCLCA 
IGGOCLCB 
IGGOCLCD 
IGGOCLCG 
IGGOCLCL 
IGGOCLCO 
IGGOCLCP 
IGGOCLCR 
IGGOCLCS 
IGGOCLCX 
IGGOCLCY 
IGGOCLC9 
IGGOCLEG 
IGGOCLES2 
IGGOCLET 
IGGOCLEX4 
IGGOCLEZ8 
IGGOCLFA 
IGGOCLFB!1 
IGGOCLFCI1 


IGGOCLFD 
IGGOCLFE 
IGGOCLFF 
IGGOCLFH 
IGGOCLFQ 
IKQDCN 
IKQONT 
IKQSCAT 
IKQVDTPE 
$$BCLCRA 


IKQGEN 
IKQTMSD 


IKQTMSF 


Module function 


Perform Define processing and free storage resour- 
ces 

Test VSAM catalog fields 

Extend VSAM data sets 

Initialize for extending VSAM data sets 

Alter an entry in catalog except when processing 
volumes 

Alter a volume entry and add data set directory to 
volume entry 

Release space to catalog 

Delete an entry from catalog 

Define a non-VSAM entry in VSAM catalog 

Delete a VSAM data space, mount volume, process 
F4 labels, remove data from volume record, and 
scratch DASD space 

Check authorization of catalog user, prompt terminal, 
and compare password 

Remove volumes for Alter processing and remove 
data set directories from volume entry 

List contents of catalog 

Perform bit manipulation against VSAM space bit 
map 

Retrieve derived VSAM catalog fields 

Modify derived VSAM catalog fields 

Read and/or write F4 labels 

Modify VSAM catalog by deleting or inserting fields 
Define data set entries and calculate size 

Define data set entries and calculate space 
Back-out Define processing and restore allocated 
space 

Define alternate index 

Release function 

CMS alter (4th module) 

1/O subroutine (2nd module) 

CMS delete space (2nd module) 

Open catalog recovery area 

Define path 

Define CRA (first module) 

Define CRA (second module) 

CMS delete (3rd module) 

CMS define (6th module) 

Act as general interface and build CCA 

Perform VSAM catalog |/O subfunctions, part 2 
Define catalog, build volume occurrences 

Check space allocation parameters 

Convert blocks to tracks 

Translate CKD data into fixed block format 
Generate partition / processor independent name 
Generate a volume list from a default model 
Extract volume information from a default model for 
use in IGGOCLFB 

Define dedicated VSAM volume 

Define space DEDICATE Load 2 

Define space ORIGIN 

Search VSAM catalog for required entry 

CMS define space Load 3 

Define console file 

Define device name and characteristics table 
Display catalog information 

Catalog device type and label area routine 

Mark deleted CRA 


Build ACB, RPL, or EXLST 

Test, modify, or display ACB, RPL, or EXLST (with 
diagnosis of input) 

Test, modify, or display ACB, RPL, or EXLST (without 
diagnosis of input) 





Component index (part 2 of 4) 


Section 4, Directory 4.5 


4.6 





Component 


| |0/C/EoVv 


DADSM 
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Module name 


IKQASNMT 
IKQBRP 
IKQCLCAT 
IKQCLIF 
IKQCLO 
IKQCLOCL 
IKQCLOVY 
IKQCLRDD 
IKQDRP 
IKQEDX 


IKQEOV 


IKQJIBSM 
IKQLAB 


IKQMTMSG 
IKQNEX 

IKQOCMSG 
IKQOCSHR 


IKQOPN 
IKQOPNAB 
IKQOPNAI 
IKQOPNCT 
IKQOPNDO 
IKQOPNDS 
IKQOPNHC 
IKQOPNNC 
IKQOPNOV 


IKQOPNPV 
IKQOPNRD 
IKQOPNRP 
IKQOPNUC 
IKQOPNUS 
IKQRBA 

IKQSTM 

IKQVRT 

$$BACLOS 
$$BCVSAM 


$$BCVS02 
$$BOVSAM 


$$BOVS01 


$$BTCLOS 


IKQALLOO 
IKQPOPOO 


IKQRDSOO 
IKQRENOO 


Module function 


Request volume mounting and logical assignment 
Build VSAM resource pool 

Update permanent data set information in the catalog 
Dynamic storage area close interface 

Disconnect a user's program from a VSAM data set 
Alternate index clean up 

Alternate index evaluation 

Close file disposition processing 

Delete VSAM resource pool 

Extend an EDB when the control blocks need to 
reflect additional space 

Mount a volume when the required volume is not 
mounted 

Build and delete JIBs (extent blocks) 

Read label information area record (DLBL/EXTENT 
statements) 

Open/close message writer (with operator response) 
Get a new extent when space is needed 

Open/Close message routine 

Lock resources required to enforce the file’s share 
option 

Connect a user's program with a VSAM data set 
Build AMDSB control block structure 

Alternate index initialization 

Open a catalog by means of special processing 
Clean up after a failure to open a data set 

Do primary allocation for dynamic data set 

Locate data set information in catalog 

Next cluster 

Build ARDB, EDB, LPMB and call IKQJIBSM for 
volume and extent processing 

Sort volume entries from catalog 

Reset reusable data set 

Attach data set to resource pool 

User catalog open 

Alternate index upgrade set determination 

Update the catalog 

Storage management 

VSAM Shared Resource Table 

Automatic close 

Provide an interface between VSE and VSAM when a 
data set is closed 

Provide common exit processing for VSAM modules 
Provide an interface between VSE and VSAM when a 
data set is opened 

Provide an interface to the VSE message writer to get 
a volume mounted for open or catalog/DADSM proc- 
essing 

Provide an interface between VSE and VSAM when a 
data set is temporarily closed 


Create a new F1 VTOC label (and F3 VTOC labels) 
from the system label area record 

Build F1 and any needed F3 VTOC labels from label 
area record (subfunction or IKQALLOO) 

Read VTOC records either by key or disk address 
Rename a specified F1 VTOC label 


Component index (part 3 of 4) 


Licensed Material — Property of IBM 


Module Directory 


Component... 


ISAM 
interface 


Service 
Aids 


Feature 
Indicator 


Figure 4.3 


Module Name. 


IKQSCROO 


IKQVTCOO 
IKQWDS00 
$$BODADE 
$$BODADS 
IIPAMTOO 
lIPBMROO 


lIPCLSOO 
IIPHPOO 
I1POPNOO 
1IPPRCMR 


lIPPRCPR 


IKQCLEAN 
IKQDUMP 
IKQDUMPC 
IKQVEDA 
$$BCVS03 
$$BCVS04 
IKQFTIND 
IKQFT1 
IKQFT2 
IKQFT3 


Module Function 


Remove an F1 label (and any associated F3 labels) 
from the VTOC 

Open or close VTOC 

Write VTOC records either by key or disk address 
Interface to DADSM from the VSE message writer 
Interface to the VSE message writer from DASDM 
Map a skeleton of the AMDTF table 

Issue an error message if a failure occurs when an 
ISAM program is trying to open or close a VSAM data 
set 

Close a VSAM data set for an ISAM program 
Link-edit phase and include statements 

Open a VSAM data set for an ISAM program 

issue error messages and cancel tasks in case an 
error occurred in SIP; issue a VSAM CLOSE for the 
data set if an error occurred during function other 
than Open or Close 

Transform an ISAM request into an equivalent VSAM 
request 


DADSM utility 

Dump non-catalog control blocks 

Dump catalog control blocks 

Enable and disable VSAM snap dump routine 
Load a phase 

1/0 routine for IKQVEDA 

Feature indicator module 

Space Management Feature 

Reserved 

Reserved 





Component index (part 4 of 4) 


The module directory (Figure 4.4) is organized alphabetically by symbolic 
module name. It lists the descriptive name, the component to which that 
module belongs, the method of operation diagram and program structure 
figure numbers in which that module is referenced, and the external entry 


point(s). 
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Module 
name 


IGGOCLAB 


IGGOCLAC 
IGGOCLAD 
IGGOCLAE 


IGGOCLAF 


IGGOCLAG 


IGGOCLAH 
IGGOCLAJ 


IGGOCLAK 
IGGOCLAL 


IGGOCLAN 


IGGOCLAP 
IGGOCLAQ 
IGGOCLAR 


IGGOCLAS 


IGGOCLAT 
IGGOCLAU 


Figure 4.4 


Descriptive name 


Catalog driver 


Master catalog search 
Master catalog open 
Define catalog open and build 


Delete catalog 


Catalog |/O subfunctions 


Search catalog (2nd module) 
Define and build data and index entries 


Complete define of an entry 
CMS define, 1st module 


CMS define, 2nd module 


CMS define, 3rd module 
Catalog define space 
Suballocate 


VSAM catalog definition processing 


CMS driver 
Suballocation 


Module directory (part 1 of 6) 
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Component 


Catalog 


Catalog 
Catalog 
Catalog 


Catalog 


Catalog 


Catalog 
Catalog 


Catalog 
Catalog 


Catalog 


Catalog 
Catalog 
Catalog 


Catalog 


Catalog 
Catalog 


Diag.# 


DJ, DL, 
ED, EF 


DB-DC 
EC-ED,El 


ED 
EC, EO 


EC,EE 
ED-EE,EG 
DH, DJ, 
ED, EE, 
EH, EK 
EC, EE, 
EH 

DB 


DJ 
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Structure 
Figure 3.x 


External 
entry points 


IGGPACDV 
IGGPRPLF 
IGGPRPLM 
IGGPMCO 
IGGPMCO2 


IGGPDCOC 
IGGPMEBM 
IGGPDCBO 


IGGPDELC 
IGGPEMIO 
IGGPEMSG 
IGGPSDSP 


IGGPISCI 
IGGPAOCI 
IGGPAXCI 


IGGPSCA 


IGGPDBDI 
IGGPDEXD 


IGGPDCMB 


IGGPDEF 
IGGPDTIM 
IGGPDCAV 
IGGPDDEP 
IGGPDCDE 
IGGPDWAI 
IGGPDSTY 


IGGPDSCB 
IGGPDBSF 
IGGPDRDA 
IGGPDCCE 
iIGGPDUND 


IGGPDCDA 
IGGPDEFS 
IGGPSALL 


IGGPDEFC 
IGGPDCRC 


IGGPCDVR 
IGGPSALS 





Module 
name 


IGGOCLAV 


IGGOCLAW 


IGGOCLAX 


IGGOCLAY 
IGGOCLAZ 


IGGOCLA6 


IGGOCLA7 


IGGOCLA8 
IGGOCLBA 


IGGOCLBB 
IGGOCLBC 


IGGOCLBD 
IGGOCLBE 


IGGOCLBF 
IGGOCLBG 


IGGOCLBH 
IGGOCLBL 
IGGOCLBM 
IGGOCLBN 


IGGOCLBQ 
IGGOCLBR 
IGGOCLBS 
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Descriptive name 


Modify catalog field 


Add group occurrence (modify) 


Alter catalog field 


Scan CPL 


Extract catalog field 


CMS define space (part 2) 


CMS delete (part 2) 


Define clean up 


Tests 


Update extend 
Update extend initialization 


Catalog alter processing 
Alter volume processing 


Subscratch 
Delete 


Define non-VSAM data set 
Delete space 

Check authorization 

Catalog alter, remove volume 


processing 


LISTCAT processing 
Suballocate bit mask handler 
Volume entry translation 


Module directory (part 2 of 6) 


Component 


Catalog 


Catalog 


Catalog 


Catalog 
Catalog 


Catalog 


Catalog 


Catalog 
Catalog 


Catalog 
Catalog 


Catalog 
Catalog 


Catalog 
Catalog 


Catalog 
Catalog 


Catalog 
Catalog 


Catalog 
Catalog 
Catalog 


Diag.# 


DB, DG, 
DH, Du, 
DL, ED-EH, 
EK, EM 
EN, EP, ER 


DG, DK, 
DL 


DG, DL 


DB, DL 


DB, DD 
DE, DH 
DJ, EK-EP 


EG, EH 


EM, EP 


ED 


DB, DE, 
DG, DK 
DL 


DB, DH 
DH 


EK 
EK 


EM, EP 
EM, EP 


EF 
EN 
DB, DD, EL 
EK 


EL 
DJ 
DK 


Structure 
Figure 3.x 


3,5 


External 


entry points 


IGGPMOD 
IGGPUPD 
IGGPSGOP 
IGGPDEL2 


IGGPADGO 
IGGPGNEX 
IGGPIGOP 

IGGPPREC 


IGGPALT2 
IGGPEXPD 
IGGPSHNK 
IGGPDGOP 
IGGPMGO 
IGGPDGO 


IGGPSCNC 


IGGPEXT 
IGGPLOC 


IGGPCOBT 
IGGPCRTC 
IGGPIVER 


IGGPVMSC 
IGGPDUSC 
IGGPDEMV 
IGGPDVMV 
IGGPERAS 
IGGPDFRS 

IGGPTSTS 

IGGPGVAL 
IGGPGREC 


IGGPUPDE 


IGGPINIT 
IGGPSVOL 


IGGPALT 


IGGPALVL 
IGGPALEC 


IGGPSSCR 


IGGPDEL 

IGGPDLDS 
IGGPDEXA 
IGGPDEXP 
IGGPDLXT 
IGGPDEFA 
IGGPDELS 
IGGPCKAU 


IGGPALVR 
IGGPALSV 


IGGPLSTC 
IGGPBMR 


IGGPXVAL 
IGGPXEXT 
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Module 
name 


IGGOCLBT 


IGGOCLBU 


IGGOCLBW 
IGGOCLBX 


IG@GOCLBY 
IGGOCLB8 


IGGOCLCA 


IGGOCLCB 


IGGOCLCD 


IGGOCLCG 


IGGOCLCL 


IGGOCLCO 


IGGOCLCP 
IG@GOCLCR 


IGGOCLCS 
IGGOCLCX 


IGGOCLCY 


IGGOCLCe! 
IGGOCLEG 


IRefer to VSE/VSAM VSAM Logic, Volume 2 for additional documentation. 


Figure 4.4 


Descriptive name 


Modify volume entry translation 


Catalog read/write F4 DSCB 


Delete/insert (modify) 
CMS define, 4th module 


CMS define, 5th module 
Define, space recovery 


Define AIX 


Release function 


CMS alter, 4th module 


VSAM catalog 1/O 
subroutine (2nd load) 


CMS delete space 
(2nd module) 


Open CRA 


Define path 
Define CRA (1st module) 


Define CRA (2nd module) 
CMS delete (3rd module) 


CMS define (6th module) 


Catalog first load 
Catalog |/O subfunctions 


Module directory (part 3 of 6) 


4.10 VSE/VSAM VSAM Logic, Volume | 


Component 


Catalog 


Catalog 


Catalog 
Catalog 


Catalog 
Catalog 


Catalog 


Catalog 


Catalog 


Catalog 


Catalog 


Catalog 


Catalog 
Catalog 


Catalog 
Catalog 


Catalog 


Catalog 
Catalog 


Structure 


Diag.# Figure 3.x 


EG, EH, 
EN, EO 


DL 
EC, ED, El 


ED 


El, EP, ER 


EE, EH 


EJ 
EH 


EH 
EM, EN, EP 


BD, DB 


DB, DC, 
DG-DL, EC, 
ED, EG, SH, 
EK-ER 
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External 
entry points 


IGGPXMOD 
IGGPXLT2 
IGGPXEL2 
IGGPXDGO 


IGGPF4RD 
IGGPF4WR 


IGGPDEIN 


IGGPDSPC 
IGGPDALR 


IGGPDRSP 


IGGPDFBO 
IGGPCNBO 


IGGPAIX 

IGGPPRPW 
IGGPCKEN 
IGGPBOUT 


IGGPRELE 
IGGPPTBF 
IGGPCLBF 
IGGPGTBF 


IGGPUPG 
IGGPALY 


IGGPRBAP 
IGGPIORA 
IGGPCHAC 
IGGPTRPL 
IGGPXIO 


IGGPDLSF 
IGGPDVSC 


IGGPCRAO 
IGGPCRAP 
IGGPGLUB 
IGGPSCAX 


IGGPPATH 


IGGPCADR 
IGGPCRBO 
IGGPGDVC 


IGGPCRVL 


IGGPDELX 
IGGPDPTH 
IGGPDELP 
IGGPDAIX 

IGGPDELY 
IGGPDELO 
IGGPDELU 


IGGPDCCO 
IGGPDPBI 
IGGPDMOP 


IGGOCLC9 


IGGPCCCR 
IGGPGET 
IGGPPAD 
IGGPPDE 
IGGPPDEC 
IGGPRCCR 
IGGPPUPC 





Module 
name 


IGGOCLES 
IGGOCLET 


IGGOCLEX 


IGGOCLEZ 
IGGOCLFA 


IGGOCLFB 


IGGOCLFC 


IGGOCLFD 


IGGOCLFE 


IG@GOCLFF 


IGGOCLFH2 


IGGOCLFQ 


lIPAMTOO 
IIPBMROO 
IIPCLSOO 
HPIIPOO 
IIPOPNOO 
IIPPRCMR 
IIPPRCPR 


IKQALLOO 
IKQASNMT 


IKQBFAOO! 
IKQBFBOO! 
IKQBRP 
IKQCISOO! 
IKQCLCAT! 
IKQCLEAN 
IKQCLIF 


IRefer to VSE/VSAM VSAM Logic, Volume 2 for additional documentation. 


Descriptive name 


VSAM Catalog definition processing 


Space allocation 


Block-to-track translation 


Track-to-block translation 


Generate partition/ processor 
independent name 


Generate volume list from 
default model 


Extract volume information 
from default model 

Dedicated VSAM volume label 
processing (Part 1) 


Dedicated VSAM volume label 
processing (Part 2) 


ORIGIN for VSAM volume 
Search catalog (1st module) 
CMS Define Space (3rd Load) 


AMDTF (control block) 

$$B message routine 

Close 

Phase and include statements 
Open 

Processor (messages) 
Processor (request translator) 


Allocate data spaces 
Mount volume and assign a 
logical unit 


Buffer manager 

LSR buffer manager 

Build resource pool 

Control interval split 

Close catalog interface function 
VTOC maintenance utility 

DSA close interface function 


Component 


Catalog 
Catalog 


Catalog 


Catalog 
Catalog 


Catalog 
Catalog 
Catalog 
Catalog 


Catalog 


Catalog 
Catalog 


ISAM 
interface 
ISAM 
interface 
ISAM 
interface 
ISAM 
interface 


ISAM 
interface 


ISAM 
interface 


ISAM 
interface 


DADSM 
0/C/EOV 


Rec. Mgmt. 
Rec. Mgmt. 
0/C/EOV 
Rec. Mgmt. 
0/C/EOV 
Serv. aids 
0/C/EOV 


2IGGOCLFH and IGGOCLAH are related catalog search modules. 
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Diag.# 
EE 


DB, DE 


EC 


DB 


CN, CO 


CM, CO 


CB, CN 
CN-CP 


CC-CL, CN, 
CP 

EG, FB 

BB, EG 


EM-EP, FE,GA 


GA 
AH 
GA 
GA 


Structure 
Figure 3.x 


NND NN 


External 


entry points 


IGGPDCVO 


IGGPFLIM 
IGGPDCHK 


IGGPDELN 
IGGPFCHK 
IGGPFCON 
IGGPDSPF 
IGGPITER 
IGGPUQRI 


IGGPLTRN 
IGGPPIN 


IGGPGVL 
IGGPGVSA 


IGGPFVXT 
IGGPGVLM 


IGGPDVV 


IGGPDEXT 


IGGPDORG 
IGGPSCAT 


IGGPASGN 
IGGPCONV 
IGGPFLIM 
IGGPLBLS 
IGGPSPC 


IIPAMTOO 


liIPBMROO 


IIPCLSOO 


IIPOPNOO 


IIPPRCMR 


liIPPRCPR 


IKQALLOO 
IKQASNMT 


IKQBFA0O 
IKQBFBOO 
IKQBRP 
IKQCISOO 
IKQCLCAT 
IKQCLEAN 
IKQCLIF 
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Module Structure External 
name Descriptive name Component Diag.# Figure 3.x entry points 

























IKQCLNLK Phase and include statement VSAM incl. - - IKQCLEAN 
IKQCLO Close function 0/C/EOV GA 7 IKQCLOOO 
IKQCLOCL AIX clean up 0/C/EOV GA 7 IKQCLOCL 
IKQCLOVY AIX evaluation 0/C/EOV GA 7 IKQVCLOV 
IKQCLRDD Close disposition processing O/C/EOV GA 7 IKQVCLRD 
IKQDCN DTF console file Catalog DD 5 IKQDCN 
IKQDNT Device name table Catalog EF = IKQDNT 
IKQDRP Delete resource pool 0O/C/EOV Al 2 IKQDRP 
IKQDUMP Block dump Serv. aids - - IKQDUMP 
IKQDUMPP | 
IKQDUMPC Dump catalog control blocks Serv. aids - - IKQDUMPC 
IKQEDX! EDB extend 0/C/EOV - - IKQEDX00 
IKQEOvV! Mount volume O/C /EOV - - IKQEOVOO 
IKQERH! Error handler Rec.Mgmt.— - 7 IKQERH 
IKQERX! VSAM error exit Rec, Mgmt. - 7 IKQERX 
IKQFTIND Feature indicator Feature - - - 
IKQFT 14 Space Management Feature Feature - - - 
IKQFT2 Reserved Feature - - - 
IKQFT3 Reserved Feature - - - 
IKQGEN GENCB: Build a new control block CB Manip. AC 2 IKQGENOO 
IKQJIBSM! Build and delete extent blocks (JIBs) 0/C/EOV BA, BB, 3,7 IKQJIBSM 
BD, GA 
IKQLAB Look at label cylinder 0/C/EOV BA, ES, FB 3,6 IKQLAB 
IKQMTMSG O/C message writer with operator reply O/C/EOV BB 3 IKQMTMSG 
IKQNEX! Get new extent O/C/EOV - - IKQNEX00 
IKQOCIMR3 VSE/VSAM Space Management for - - - IKQOCIMR 
Sam Feature 
IKQOCMSG! Open/Close message routine 0/C/EOV 3,7 IKQOCMSG 
IKQOCSHR File sharing control 0/C/EOV BA, BD, GA 3,7 IKQOCSHR 
IKQOPN Open function 0/C/EOV BA, BB 3 IKQOPN 
IKQOPNAB Build AMDSB 0/C/EOV BB 3 IKQOPNAB 
IKQOPNAI Alternate index initialization 0/C/EOV BA 3 IKQOPNAI 
IKQOPNCT Open catalog 0/C/EOV BA 3 IKQOPNCT 
IKQOPNDO Clean up after open failure 0/C/EOV BA, BD 3 IKQOPNDO 
IKQOPNDS Do primary allocation for 0/C/EOV BA 3 IKQOPNDS 
dynamic data set 
IKQOPNHC Locate data set information in catalog 0/C/EOV BA 3 IKQOPNHC 
IKQOPNNC Next cluster 0/C/EOV BA, BC 3 IKQOPNNC 
IKQOPNOV Open volume extent 0/C/EOV BB 3 IKQOPNOV 
IKQOPNPV Sort volume entries 0/C/EOV - 3 IKQOPNPV 
IKQOPNRD Reset reusable data set 0/C/EOV BA 3 IKQOPNRD 
IKQOPNRP Attach data set to resource pool 0/C/EOV BB 3 IKQOPNRP 
IKQOPNUC User catalog 0O/C/EOV BA 3 IKQOPNUC 
IKQOPNUS Alternate index upgrade set 0/C/EOV BA 3 IKQOPNUS 
determination 
IKQOPNVC3 VSE/VSAM Space Management for - - : IKQOPNVC 
SAM Feature 
IKQPFOOO! Format data CA or index CNV Rec.Mgmt. GA 7 IKQPFOOO 
IKQPOPOO Build VTOC labels DADSM FB, FE 6 IKQPOPO0O 


IKQRBA! Update catalog for sharing 0/C/EOV IKQRBAOO 





Refer to VSE/VSAM VSAM Logic, Volume 2 for additional documentation. 
2 IGGOCLFH and IGGOCLAH are related catalog search modules. 
2 Refer to VSE/VSAM Space Management for SAM Logic for additional documentation. 
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Module 
name 
IKQRCLOO! 
IKQRDSOO 


IKQRENOO 
IKQRQA! 
IKQRQB! 
IKQRQC! 
IKQSCAT 


IKQSCROO 


IKQSFT! 
IKQSMACL3 


IKQSTM 
IKQTMSD 


IKQTMSF 
IKQVDTPE 
IKQVEDA 


IKQVSMLK 
IKQVSMI 
IKQVTCOO 


IKQWDSO0O0 
$SVAVSAM 
$$BACLOS 
$$BCLCRA 
$$BCVSAM 
$$BCVS02 
$$BCVSO03 
$$BCVS04 
$$BODADE! 
$$BODADS 


$$BOVSAM! 


$$BOVS01 


$$BTCLOS 


Descriptive name 


Record management close 
Read VTOC labels 


Rename data set 

Request analyzer 1 
Request analyzer 2 
Request analyzer 3 


SHOWCAT: Display catalog 
information 


Scratch VTOC labels 


Shift 


VSE/VSAM Space Management for 
SAM Feature 


Storage manager 


MODCB, SHOWCB, TESTCB: Modify, 
display, or test a control block 


MODCB, SHOWCB, TESTCB: Modify, 
display, or test a control block 


Device type routine 


Enable and disable VSAM 
diagnostic aids 


Phase and include statements 
VSAM request driver 
Open/Close VTOC 


Write VTOC labels 

SVA module list 
Automatic close 

Mark deleted CRA 

Close interface 

Common exit 

LKMOD routine 

1/0 routine for IKQVEDA 
End of message interface 
Start of message interface 
Open interface 


Catalog/DADSM interface to mount 
volume 


TCLOSE interface 


Structure 


Component  Diag.# Figure 3.x 


Rec. Mgmt. 
DADSM 


DADSM 
Rec. Mgmt. 
Rec. Mgmt. 
Rec. Mgmt. 
Catalog 


DADSM 


Rec. Mgmt. 


0/C/EOV BD 
CB. Manip. AD-AG 


CB. Manip. AD-AG 


Catalog ED, EE, 


EG, EN, EO 
Serv. Aids - 


VSAM - 

Rec. Mgmt. GA 

DADSM EG, EN, 
FB-FD, FH 

DADSM FE, FG 

VSAM - 

0/C/EOV GA 

Catalog EN 

O/C/EOV 

0O/C/EOV 

Serv. aids 

Serv, aids 

DADSM 

DADSM 

O/C/EOV 

0O/C/EOV 


0/C/EOV 


External 
entry points 
IKQRCLOO 
IKQRDSOO 


IKQRENOO 
IKQRQA 
IKQRQB 
IKQRQC 
IKQSCAT 


IKQSCROO 


IKQSFT 
IKQSMACL 


IKQSTM 
IKQTMSD 


IKQTMSF 
IKQVDTPE 


IKQVEDA 


IKQVSM 
IKQVTCOO 


IKQWDSOO 
$SVAVSAM 
$$BACLOS 
$$BCLCRA 
$SBCVSAM 
$SBCVS02 
$$BCVS03 
$$BCVS04 
$$BODADE 
$$BODADS 
$$BOVSAM 
$$BOVS01 


$$BTCLOS 





1 Refer to VSE/VSAM VSAM Logic, Volume 2 for additional documentation. 
3. Refer to VSE/VSAM Space Management for SAM Logic for additional documentation. 
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Routine Directory 


Some of the VSAM modules contain several routines which are listed 
alphabetically by the entry points along with the appropriate module. 
Figure 4.5 contains catalog management modules. 














Entry point Module name 


IGGPACDV IGGOCLAB Catalog management driver 
IGGPADGO IGGOCLAW Add group occurrence 


Procedure description 





















IGGPAIX IGGOCLCA Define AIX 

IGGPALEC IGGOCLBE Check for index or data and sequence set with 
data 

IGGPALSV IG@GOCLBN Rename DSCBs for alter data set name function 

IGGPALT IGGOCLBD ALTER processing 

IGGPALT2 IGGOCLAX ALTER catalog record's field value 

IGGPALVL IGGOCLBE ALTER: Volume processing 

IGGPALVR IGGOCLBN ALTER: Remove volume processing 

IGGPALY IGGOCLCD Get and initialize work area for upgrading/no- 
upgrading routine 

IGGPAOCI IGGOCLAG Assign contiguous control intervals 

IGGPASGN IGGOCLFQ Assign symbolic unit to volume 

IGGPAXCI IGGOCLAG Assign one control interval 















IGGPBMR IGGOCLBR Suballocate bit mask handler 
IGGPBOUT IGGOCLCA Backout AIX or path association group occur- 
rence 











IGGPCADR IGGOCLCR Build CRA 


















IGGPCCCR IGGOCLEG Checkpoint the catalog control record (CCR) 

IGGPCDVR IGGOCLAT Catalog management services common process- 
ing 

IGGPCHAC IGGOCLCG Compute RBAs for next extent 

IGGPCKAU IGGOCLBM Check the caller’s authorization to access the 
catalog record 

IGGPCKEN IGGOCLCA Check entry name and entry name of related 
object 

IGGPCLBF IGGOCLCB Clear buffer 

IGGPCNBO IGGOCLB8 Remove candidate volume occurrences 

IGGPCOBT IGGOCLA6 Obtain VTOC entries 

IGGPCONV IGGOCLFQ Convert blocks to tracks 

IGGPCRAO IGGOCLCO Open catalog recovery area (CRA) 

IGGPCRAP IGGOCLCO CRA password checking 

IGGPCRBO IGGOCLCR Back out volume record and reset TT-pointer 

IGGPCRTC IGGOCLA6 Convert records to tracks 

IGGPCRVL IGGOCLCS Suballocate CRA and write initial CRA records 












IGGPDAIX IGGOCLCX Implicit delete AIX (for DEL cluster request) 
IGGPDALR IGGOCLBX Average logical record size FPL structure 















processing 
{GGPDBDI IGGOCLAJ DEFINE: Build the data set and index catalog 
records of a cluster 
IGGPDBSF IGGOCLAN Buffer size FPL structure processing 
IGGPDCAV IGGOCLAL Cross check and validity check 
IGGPDCBO IGGOCLAE Define space backout 
IGGPDCCE IGGOCLAN DEFINE: Build the cluster’s catalog record 
IGGPDCCO IGGOCLCY Determination of data and index characteristics 
IGGPDCDA IGGOCLAP DEFINE Catalog processing (2 of 2) 
IGGPDCDE IGGOCLAL Date and entry name processing 
IGGPDCHK IGGOCLET Input validity check 
IGGPDCMB IGGOCLAK DEFINE: Completion (build the volume informa- 






tion group occurrence) 
DEFINE Catalog: Catalog open, build, and close 





IGGPDCOC IGGOCLAE 
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Entry point 


IGGPDCRC 
IGGPDCVO 
IGGPDDEP 
IGGPDEF 
IGGPDEFA 
IGGPDEFC 
IGGPDEFS 
IGGPDEIN 
IGGPDEL 
IGGPDELC 
IGGPDELN 
IGGPDELO 
IGGPDELP 
IGGPDELS 
IGGPDELU 
IGGPDELX 
IGGPDELY 
IGGPDEL2 
IGGPDEMV 


IGGPDEXA 























































IGGPDEXD 
IGGPDEXP 
IGGPDEXT 
IGGPDFBO 
IGGPDFRS 
IGGPDFS2 


IGGPDGO 
iGGPDGOP 


IGGPDLDS 
IGGPDLSF 
IGGPDLXT 
iGGPDMOP 
IGGPDORG 
IGGPDPBI 
IGGPDPTH 


IGGPDRDA 
IGGPDRSP 
IGGPDSCB 


IGGPDSPC 
IGGPDSPF 
IGGPDSTY 
IGGPDTIM 

IGGPDUND 
IGGPDUSC 


IGGPDVMV 
IGGPDVSC 
IGGPDVV 


IGGPDWAI 


IGGPEMIO 


IGGPEMSG 
IGGPERAS 


IGGPEXPD 
IGGPEXT 
IGGPFCHK 
IGGPFCON 
IGGPFLIM 
IGGPFVXT 
IGGPF4PR 
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Module name 


IGGOCLAS 
IGGOCLES 
IGGOCLAL 
IGGOCLAL 
IGGOCLBH 
IGGOCLAS 
IGGOCLAQ 
IGGOCLBW 
IGGOCLBG 
IGGOCLAF 
IGGOCLEX 
IGGOCLCX 
IGGOCLCX 
IGGOCLBL 
IGGOCLCX 
IGGOCLCX 
IGGOCLCX 
IGGOCLAV 
IGGOCLA7 


IGGOCLBG 


IGGOCLAJ 
IGGOCLBG 
IGGOCLFE 
IGGOCLB8 
IGGOCLA8 
IGGOCLA6 


IGGOCLAX 
IGGOCLAX 


IGGOCLBG 
IGGOCLCL 
IGGOCLBG 
IGGOCLCY 
IGGOCLFF 
IGGOCLCY 
IGGOCLCX 


IGGOCLAN 
IGGOCLBY 
IGGOCLAN 


IGGOCLBX 
IGGOCLEX 
IGGOCLAL 
IGGOCLAL 
IGGOCLAN 
IGGOCLA7 


IGGOCLA7 
IGGOCLCL 
IGGOCLFD 


IGGOCLAL 


IGGOCLAF 
IGGOCLAF 
IGGOCLA7 
IGGOCLAX 
IGGOCLAZ 
IGGOCLEX 
IGGOCLEX 
IGGOCLFQ 
IGGOCLFC 
IGGOCLA6 












Procedure description 





Compute RBAs of data space 
Build volume group occurrences 

Date and entry name processing 

DEFINE common processing 

DEFINE non-VSAM processing 

DEFINE Catalog processing (1 of 2) 

DEFINE Space processing 

Modify: Delete /insert processing 

DELETE Cluster/non-VSAM processing 
DELETE Catalog processing 

Check if catalog is open 

Check if cluster or AIX data set is open 

Delete path driver 

DELETE Space processing 

Unlock cluster or AIX 

Delete AIX driver 

Delete and upgrade set (for DEL cluster request) 
Delete a group occurrence 

DELETE: Extract the volume information group 
occurrence 

Build interface to extract cluster, AIX, or path 
associations 

Delete work area 

Extract the password of a cluster or an AIX 
DEDICATE processing 

DEFINE: Space recovery 

Free unused and unneeded storage resources 
DEFINE Space: Build the space header, space 
descriptor group, and data set directory entry 
group occurrences 
MODIFY: Delete group occurrence processing 
MODIFY: Delete group occurrence pointer 
processing 

Delete the space of the cluster or AIX 

Forced delete space 

Delete clean up routine (exit) 

Complete entry construction process 

ORIGIN processing 

Determine physical biock size index value 
Implicit delete path (for DEL cluster or DEL AIX 
request) 

Regular define AMDSB processing 

DEFINE Cluster processing (5th module) 
DEFINE common processing (space calculations 
and build the cluster catalog record) 

DEFINE Cluster processing (4th module) 

Space parameter FPL structure processing 
Security FPL structure checking 

DEFINE: Cail the system timer 

DEFINE: Undo the previous processing 
DELETE: Scratch the data space (format-1 label) 
from the volume's VTOC 

DELETE: Mount and verify volumes 

Clean VTOC from VSAM spaces 

DEFINE DEDICATE/ORIGIN VSAM volume label 
processing 

Work area initialization 














|/O error message writer 
Error message writer 
DELETE: Erase data component 

Expand a catalog record's variable-length field 
Extract processing 

Check FVT space parameter consistency 
Convert blocks to tracks in all FVTs 

Convert blocks to tracks or cylinders 

FREEVIS of GVL storage 

Read format-4 label and either set or reset time 
stamps, CRA pointer and ownership 


External entry points of catalog management modules (part 2 of 4) 
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Entry point 


IGGPF4RD 
IGGPF4WR 


IGGPGDVC 
IGGPGET 


IGGPGLUB 
IGGPGNEX 


IGGPGREC 
IGGPGTBF 
IGGPGVAL 
IGGPGVL 

IGGPGVLM 


IGGPGVSA 


IGGPIDMP 
IGGPIGOP 
IGGPINIT 
IGGPIORA 
IGGPISCI 
IGGPITER 
IGGPIVER 


IGGPLBLS 
IGGPLOC 

IGGPLSTC 
IGGPLTRN 


IGGPMCO 
IGGPMCO2 
iIGGPMEBM 
IGGPMGO 
IGGPMOD 
IGGPPAD 


IGGPPATH 
IGGPPDE 


IGGPPDEC 
IGGPPIN 
IGGPPREC 


IGGPPRPW 
IGGPPTBF 
IGGPPUPC 


IGGPRBAP 
IGGPRCCR 
IGGPRELE 
IGGPRPLF 
IGGPRPLM 


IGGPSALL 
IGGPSALS 
IGGPSCA 
IGGPSCAT 
IGGPSCAX 
IGGPSCNC 
IGGPSDSP 


Figure 4.5 
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Module name 


IGGOCLBU 
IGGOCLBU 


IGGOCLCR 
IGGOCLEG 


IGGOCLCO 
IGGOCLAW 


IGGOCLBA 
IGGOCLCB 
IGGOCLBA 
IGGOCLFB 


IGGOCLFC 
IGGOCLFB 


IGGOCLAT 
IGGOCLAW 
IGGOCLBC 
IGGOCLCG 
IGGOCLAG 
IGGOCLEX 
IGGOCLA6 


IGGOCLFQ 
IGGOCLAZ 
IGGOCLBQ 
IGGOCLEZ 


IGGOCLAC 
IGGOCLAD 
IGGOCLAE 
IGGOCLAX 
IGGOCLAV 
IGGOCLEG 


IGGOCLCP 
IGGOCLEG 


IGGOCLAG 
IGGOCLFA 
IGGOCLAW 


IGGOCLCA 
IGGOCLCB 
IGGOCLEG 


IGGOCLCG 
IGGOCLEG 
IGGOCLCB 
IGGOCLAB 
IGGOCLAB 


IGGOCLAR 
IGGOCLAU 
IGGOCLAH 
IGGOCLFH 
IGGOCLCO 
IGGOCLAY 
IGGOCLAF 


Procedure description 


Read the format-4 label 
Write the format-4 label 


Get device characteristics for define CRA 

Get catalog record: Call record management to 
retrieve a catalog record 

Get LUB index associated with CRA volume 
Get an available RAB and format a new catalog 
extension record 

Retrieve a catalog record 

Get buffer 

Locate a catalog record field 

Generate volume list 

Extract volume information from the default 
model 

Build volume list after sub-allocation failed 


Issue an IDUMP 

Insert a group occurrence pointer 
Update-Extend: Initialization 
Error code analyzer 

Insure control-interval availability 
Adjust data Cl size 

Initialize volume entry record 


GETVIS space for dummy label 

Locate processing 

LISTCAT processing 

Translate CKD field into fixed block format 


DEFINE Catalog: Master catalog build and open 
(1 of 2) 

DEFINE Catalog: Master catalog build and open 
(2 of 2) 

Handle multiple extents for catalog open and 
build 

Move group occurrence from one extension 
record into another 

Modify common processing 


PUT-Add: Cail record management to write a 
new catalog record 

Define path 

ERASE: Call record management to erase a 
catalog record 

Delete catalog record 

Create partition/processor independent name 
Call PUT-Add or PUT-Update to write a catalog 
record 

Check password of related object 

Put into buffer 

PUT-Update: Call record management to rewrite 
a catalog record 


Scan the ARDBs and AMDSBs for all RBAs 
Read catalog control record 

Release function 

Dequeue the catalog 

Assign RPLs from the catalog RPL pool 


Suballocate: Candidate volume assignment 
Suballocate: Space assignment 

Set catalog ACB address/open user catalog 
Search catalog processing 

Scan CAXWA chain 

Initial CTGPL processing 

Remove space and close CRA 
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Entry point 


IGGPSGOP 
IGGPSHNK 
IGGPSPC 


IGGPSSCR 


IGGPSVOL 


IGGPTRPL 
IGGPTSTS 


IGGPUPD 
IGGPUPDE 
IGGPUPG 


IGGPUQRI 


IGGPVMSC 
IGGPVMTV 


IGGPXDGO 
IGGPXEL2 
IGGPXEXT 


IGGPXIO 
IGGPXLT2 


IGGPXMOD 
IGGPXVAL 
IGGOCLC9 
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Module name 


IGGOCLAV - 


IGGOCLAX 
IGGOCLFQ 


IGGOCLBF 
IGGOCLBC 


IGGOCLCG 
IGGOCLBA 


IGGOCLAV 
IGGOCLBB 
IGGOCLCD 


IGGOCLEX 


IGGOCLA7 
IGGOCLAG6 


IGGOCLBT 
IGGOCLBT 
IGGOCLBS 
IGGOCLCG 
IGGOCLBT 
IGGOCLBT 
IGGOCLBS 
IGGOCLC9 


Procedure description 


Retrieve the group occurrence pointer 

Shrink a catalog record’s variable-length field 
Convert track allocation for DEDICATE and 
ORIGIN 

Subscratch: Release a cluster's space within a 
VSAM data space 

Search for the volume information group 
occurrence 


Test RPL last used 
CTGFL-for-tests processing 


Update catalog field 

Update-Extend processing 

Add an AIX to the upgrade set (UPGRADE) or 
delete an AIX from the upgrade set 
(NOUPGRADE) 

Build space return information for unique data 
set 


DELETE: Delete all space information in the 
volume catalog record 
Volume mount 


Add derived group occurrence 
Delete derived group occurrence 
Extract derived group occurrence 
1/O routine for catalog and CRA 
Alter derived field value 

Modify derived group occurrence 
Get derived field value 

Catalog management first load 





External entry points of catalog management modules (part 4 of 4) 
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Control Block Directory 
The control block directory (Figure 4.6) contains a short entry for each of 
the most important VSAM control blocks for the VSAM components 
documented in this volume, giving the length and the purpose of each block. 


4.18 


Data Area 


ACB 
AMBL 
AMCBS 


AMDSB 


AMDTF 


CAXWA 


CCA 


CTGFL "(also 
known as 

FPL or FL) 
CTGFV *(also 
known as FVT) 
CTGPL* (also 


known as 
CPL) 


DASDM 
parameter list 


DTFIS 


EDB 
OAL 


Total size 


68 bytes 
112 bytes 
28 bytes 


200 bytes 


469 bytes 


156 bytes 


1456 bytes 


24 bytes + 
field pointers 


92 bytes 


40 bytes + 
field pointers 


168 bytes 


variable 
depending on 


function performed 


52 bytes 


24 bytes + 
8 X number of 


Purpose 


To describe a VSAM cluster 

To connect an ACB to the PLH and AMDSB(s) 
To contain addresses of CAXWA chain, master 
and job catalog ACBs, and recovery information 


To record data set status and statistics (not 
including buffer header and first EDB) 

To contain save areas, lists, addresses for ISAM 
interface programs, and the error message build 
area 


To contain pointers to control blocks and work 
areas needed when a Catalog is being processed 


To contain information about the catalog being 
processed and about the catalog record and its 
extensions 

To contain catalog field name, address, and 
length 


To contain addresses of user-supplied 
information fields and lists 


To contain a description of the call for catalog 
management services 


To contain the input parameters for 
the DASD Space Management routines 


To describe an ISAM file 


To contain the extent descriptions 
To contain all opened VSAM ACBs 


open ACBs (max. 14) 


2172 bytes 
52 bytes 
20 bytes 


76 bytes 


To contain information needed when a data set 
is being opened 

To contain user request information and error 
feedback information 

To contain the input parameters needed for 
building the VSAM Resource Pool 


To contain information and pointers for the 
resource pool 





* Rebuilt for each use, that is, not permanent. 


Figure 4.6 
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VSAM Data Set 


VSAM Record 


Control Interval 


Section 5: Data Areas 


This section deals with the internal data areas of VSAM, describing their 
formats, functions, and interrelationships. It is assumed that you are famili- 
ar with the basic structure of VSAM, such as the types of data sets, the 
structure of indexes, the concept of the catalog, etc., as these are described in 
Using VSE/VSAM Commands and Macros. 


The section is divided into two parts: 
¢ Descriptions of the VSAM data set, index, alternate index, and catalog. 


e Description and format of the VSAM control blocks, together with 
figures showing their interrelationships. 


VSAM control blocks that do not appear in this volume are documented in 
VSE/VSAM VSAM Logic, Volume 2. 


A VSAM data set is a collection of records grouped into control intervals. 
Control intervals are grouped into larger units called control areas. If the 
VSAM data set is key-sequenced, then the control interval(s) in which it 
resides are pointed to by entries in an associated index. The VSAM stored 
record, control interval, control area, and index are described in the topics 
that follow. 


Records are normally treated by VSAM as variable-length records. Records 
can be spanned across control intervals within a control area, and their 
maximum size is thus equal to the length of a control area. The only excep- 
tion to this is a relative-record data set, whose records must have a fixed 
length. 


A control interval is a continuous area of auxiliary storage that VSAM uses 
for storing records. The control interval is the unit of information that 
VSAM transfers between virtual and auxiliary storage. 


The length of each control interval is an integral multiple of block size. The 
size of a control interval is determined by the system from the size of the 
records, user-specified minimum buffer size, device characteristics, and the 
user-specified percentage of free space. You can specify the size of the 
control interval, but it must be within limits acceptable to VSAM. Control 
interval length must be in the range 512 to 32,768. If the length is between 
512 and 8,192, the value must be a multiple of 512; if the length is between 
8,193 and 32,768, the value must be a multiple of 2,048. 


Data records are put in the low-address portion of the control interval. 
Control information about each data record is put in the high-address 
portion of the control interval. The combination of a data record and its 
control information, though they are not physically adjacent, is called a 
stored record. The control information in a control interval consists of a 
Control Interval Definition Field and one or more Record Definition Fields. 
Figure 5.1 shows the format of a control interval. 
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Control Interval Definition Field 


Record Definition Field 
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Record |Record {Record 
1 2 3 


eo 









Free Space 


RDF/|RDF| RDF 
ain 


Figure 5.1 Control interval format 


The Control Interval Definition Field (CIDF) describes the control interval. 
Its format is shown in Figure 5.2. 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 
6) 6) 2 CIDFDD Free space offset (binary) 
Displacement from the beginning of the 
control interval to the beginning of the 
free spacel 
2 2 2 CIDFLL Free space length (binary) 


Length of the free space area within this 
control interval! 


2 Tent CIDFDDP The process of moving records from this 
control interval to another has not com- 
pleted; duplicate records may exist. 


! lf the CIDF contains only Os, end-of-data-set or end-of-key-range is indicated; either 


the end of the data set was detected or the end of a key range in a key-sequenced 


data set was detected when the data set was to be divided between volumes. Informa- 
tion in the volume group occurrence (see VOLFLG) in the data set’s catalog record 
helps to differentiate between the end-of-data-set and end-of-key-range conditions. _ 


Figure 5.2 Control interval definition field format 


The Record Definition Fields (RDFs) describe the records in the control 
interval. They are inserted into the control interval from right to left, which 
means that the rightmost RDF describes the leftmost data record. 


There is normally one RDF for each record, except in two special cases. 
These are: 


When two or more consecutive records in the control interval have the 
same length. In this case, two RDFs are used to describe the whole 
group of records. The first (right-hand) RDF describes the characteris- 
tics of the records, and the second (left-hand) RDF contains a count of 
the number of records. 


Note that this is true only for key-sequenced and entry-sequenced data 
sets. The slots or records in a relative record data set have a fixed length, 
but specific information is required for each one. The records cannot, 
therefore, be grouped, and one RDF is required for each record. 


When the record is spanned. In this case, only one segment of one 
record can be located in the control interval. Nevertheless, two RDFs 
are used. The first (right-hand) RDF describes the record segment, and 
the second (left-hand) RDF contains a “level number’’, which is used for 
data integrity checking. This number 1s assigned and updated by VSAM 
whenever the spanned record 1s processed. The level number in all 
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segments of a spanned record will always be the same, unless an error 
has occurred. 
The format of an RDF is shown in Figure 5.3. 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


RDFFLAG Flag byte 
RDFEXT RDF extension flag 


There is no RDF to the left of this RDF 
that contains additional information 
about record(s) described in this RDF. 


There is an RDF to the left of this RDF 
that contains additional information 
about the record(s) described in this 
RDF. Byte two and three of the RDF to 
the left contain the following information: 


e if there are more consecutive records 
than one of fixed length they contain 
the number of these records begin- 
ning with the record associated with 
the previous (to the right) RDF (see 
replication count flag) 


in the case of spanned records they 
contain the level number 


This is the only segment of a stored 
record.: 


RDFSRM The RDF to the left contains information 
about spanned records (middle segment) 


RDFSRL The same as above but last segment 
RDFSRF The same as above but first segment 
RDOFREPL Replication count flag 


The second and the third bytes of this 
RDF contain the data record's length 


This RDF contains additional information 
about the record(s) described in the RDF 
to the right. 


RDFRESL Empty slot indicator (for relative record 
processing where one RDF is associated 
with one slot in the control interval - no 
extended RDFs) 


The record in the corresponding slot is 
invalid (it has been deleted or not yet in- 
serted) 


The record in the corresponding slot is 
valid 

Depending on the kind of record(s) 
described, byte two and three of an RDF 
contain one of the following values: 





Figure 5.3 Record definition field format (part 1 of 2) 
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Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


1 1 2 RDFLL Length field 


Always present in the rightmost (or only) 
RDF for a record or group of fixed-length 
records. 


| These bytes contain the data record's 
length or the length of the segment of a 
spanned record. 


1 | 2 RDFCOUNT Count field 


These bytes contain the number of 
consecutive fixed-length records. Itis a 
type of RDF that contains additional in- 
formation about the records described in 
the RDF to the right. 


Byte O (of the RDF to the right) Bit 4 = 1, 
Bits 2,3 =0 


1 1 2 RDFSRLVL Level number 


| These bytes contain the level number for 
spanned records. It is a type of RDF that 
contains additional information about the 
records described in the RDF to the 
right. 


Byte O (of the RDF to the right) Bit 4 = 1, 
Bits 2,3 = 11 0r 10 0r 01 


Figure 5.3 Record definition field format (part 2 of 2) 


Control Area 


A control area consists of control intervals; the number of control intervals 
in a control area is determined by VSAM. The control area is the amount of 
space that VSAM preformats so that data integrity is ensured for records 
added to a data set. 


Control areas are also used to simplify and localize the movement of records 
when records are inserted in a key-sequenced data set. If an insertion 
requires a free control interval and there isn’t one, a control-area split 
results. VSAM establishes a new control area and moves the contents of 
approximately half of the full control area to free control intervals in the 
new control area. The new records, as their keys dictate, are then inserted 
into one of the two control areas. The control area has no specific control 
information. 
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Index 
An index is created at the same time as a key-sequenced data set. The index 
structure exists in its own address space and consists of one or more levels. 
The lowest level or sequence set consists of one or more index records. There 
is an index record in the sequence set for each formatted control area. 
Within a sequence-set record there is either an index entry or a free data 
control interval pointer for each control interval in the control area. (Free 
data control interval pointers are discussed later in this section.) The key in 
each entry of a sequence set record is the same as the key of the last (highest) 
entry in the corresponding control interval. To save space, VSAM com- 
presses the keys in the index. 


The upper levels of the index are collectively called the index set, and 
contain index entries which point to the next lower level of the index. 
Figure 5.4 shows a simple index structure. 


Index Set 


Index 10080 | 14028 [7 ~~ = | 18080 | 20000 











Sequence Set | 10009 | 10080 14000 | 14028 18040} 18080 


Index control interval 


/ f[/ Vie containing index record 


4, li 
10082] 10060] 10070 |rooso} ts YY @ one control area 





Data 
, 
10334 [raooo soo [rao] sO 
y FS — free space 
14021 | 14023 | 14024 |14028 |  lrs ts 
}14021 | 14023 |14024 |14028 | Yy —— = — horizontal pointers 
————- — vertical pointers 
WY — control information 
Y W 
| rti“‘(‘Céié SUC 
Figure 5.4 Example of a simple VSAM index 
Index Record 


The index records and control intervals are fully compatible with VSAM 
data records and control intervals, and are handled by record-management 
modules in the same way. The only differences between index records and 
data records are: 
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e There is only a single index record in an index control interval (and thus 
only one RDF). 

e =The internal format of an index record is fixed. This format is shown in 
the example of Figure 5.5, and its various parts are discussed. 


Pointer | Pointer] Pointer | Pointer Entry |] Entry | Entry | Entry 


Free data control Index entries 
interval pointers 






Space for entries 





Figure 5.5 Example of an index control interval 
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Index Record Header 
The index record header contains the information needed to insert index 
entries, to locate entries within the record, and to convert pointers into 
RBAs. The format of the index record header is shown in Figure 5.6. 





Offset Field 
Dec Hex Field Name Size Description 


IXRL Length in bytes, of the index record, 
including this field. 


IXCINL Length, in bytes, of the control information 
(the IXENTRYF, IXENTRYL, and IXEN- 
TRYP fields) in each index entry. 


IXPMASK Length of the pointers to free data control 
intervals in this index record!. This field is 
used as a mask for insert character (store 
character) under mask instructions that 
are used to access pointers. The value 
contained in this field specifies the length 
of these pointers, as follows: 


B'0001' 1-byte pointer 
B'0011' 2-byte pointer 
B'0111° 3-byte pointer 

IXBASRBA For a sequence-set index record, the RBA 
of a data control area that contains data 
to be referenced. This RBA and index- 
entry pointers are used together to calcu- 
late the 4-byte RBA of another index re- 
cord or of a data control interval (O for 
high-level indexes). 


IXNXTIR Pointer to the logically next index record 
in this index level. (Horizontal pointer) 


Reserved (0). 


IXLVLNO index level number. A sequence-set index 
is assigned a value of 1; the next higher- 
level index is assigned a value of 2; etc. 


Reserved (0). 


IXINSOS Displacement from the beginning of this 
record to the space available for inserting 
index entries. For higher-level indexes, 
the entry space immediately follows the 
record header: for sequence-set indexes, 
the entry space follows the record header. 
and free data-control-interval pointers. 


IXLENTRY Displacement from the beginning of this 
record to the last (high-key) entry in the 
index record.2 


IXFSECTN Displacement from the beginning of this 
record to the first (low key) section entry 
in the index record.2 


! Pointers are allowed to vary in length to conserve index space. If, for example, the 
number of items to be referenced by an index record is less than 256, a one-byte 
pointer can be used; if the number is greater than 256 and less than 65,536, a 
two-byte pointer can be used; and if the number is greater than 65,536, a three- 
byte pointer can be used. 


2 This displacement is to the F (front-key compression count) byte of the entry, not to 
the beginning of the entry. 


Figure 5.6 Index record header format 
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Free Data-Control-Interval Pointers 


Free data-control-interval pointers, which exist only in sequence-set index 
records, are used to calculate the RBAs of available data control intervals. 
The length of a pointer is specified in the record header. 


When the index is first built, and before records have been loaded into the 
data set, the index records of the sequence set contain one free data control 
interval pointer for each data control interval. 


VSAM always uses the rightmost free data-control-interval pointer when a 
data control interval is needed. The value of the pointer is set to 0 when the 
control interval is used. As pointers are set to 0, the displacement to space 
that is available for index entries (contained in the record header) is adjust- 
ed by the length of the free data-control-interval pointer. In this way, space 
used by free data-control-interval pointers is made available for index 
entries when the pointers are no longer required. 


The example in Figure 5.5 shows a sequence set record for a control area 
with eight control intervals. Of these eight, the first four are now occupied 
by data, and the last four are still free. 


Index Entries 


The index entries are the link between the index and the data set. They 
contain the key, the pointer to the data control interval containing the data 
record, and information about key compression. The format of an index 
entry is shown in Figure 5.7. 


Field Size 
(in bytes) Field Name Description 


Variable IXKEY Key characters that determine the sequence of records 
. in a key-sequenced data set. 


IXENTRYF Front-key compression count, that is, the number of 
(F byte) characters by which the beginning of the key has been 
compressed. 


IXENTRYL Length of the IXKEY field. 

(L byte) 

IXENTRYP Pointer to an index or data control interval. 

(P field) This value is the number of the Cl within the CA (for 
example ‘4’ for the fifth Cl). To calculate the RBA of 
the Cl, this value must be multiplied by the Cl size and 
added to the contents of IXBASRBA. 





Figure 5.7 Index entry format 


Index Entries for Spanned Records 
Since spanned records extend across two or more data control intervals, 
their index entries, sometimes called ‘complex index entries’, consist of a 
series of ‘normal’ entries (one for each data control interval). These entries, 
in turn, are basically standard index entries, but they have some special 
features: 


e The key is contained only in the entry for the last segment of the span- 
ned records, whose F byte contains the actual key compression count. 


e The entries for all other segments contain no key, and their F byte 
contains a compression count equal to the key length, thus indicating a 
key length (in the entry) of zero. 


e Each entry contains a pointer to its associated segment (or data control 
interval). 
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Index Entry Sections 


To save time when searching index records for a given key, the index entries 
are grouped into sections. This allows a rapid search, scanning only the 
highest key in each section, to locate the correct section, which is then 
searched for the correct key. 


A section is defined by a two-byte field to the left of the high-key entry in 
the section. This field contains the displacement from the F byte of the 
high-key entry in this section to the F byte of the high-key entry in the next 
section (to the left). The index record header contains a pointer to the F 
byte in the high-key entry in the first section. 


For technical reasons, this division of the index entries into sections is not 
carried out until a control interval split is necessary in a control area. There 
will thus be no section definition fields in the index of a freshly loaded data 
set, and only some of the sequence set records in an ‘older’ data set will have 
such fields. 
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Alternate Index 
The alternate index (AIX) provides an alternate means of access, using 
different keys, to the data records in the base cluster, which can be a key- 
sequenced or entry-sequenced data set, but not a relative-record data set. 
The alternate index itself is a key-sequenced data set. The index component 
of the AIX is identical in structure, format, and function to the index of any 
other key-sequenced data set. The basic structure of the data component of 
the AIX is also identical to that of a normal key-sequenced data set, as far as 
CIDFs and RDFs are concerned. 


The only difference in format between the AIX and a normal key-sequenced 
data set concerns the records in the data component of the AIX, which have 
a fixed format, shown in Figure 5.8. These records form the logical connec- 
tion between the AIX and the base cluster, and contain control information, 
the alternate key, and one or more pointers to the base cluster. If this base 
cluster is a key-sequenced data set, the pointers consist of the prime keys of 
the required data records, which are then located by means of the base 
cluster index. If the base cluster is an entry-sequenced data set, which has 
no index, the pointers are relative-byte addresses (RBAs) of the required 
records, which can then be located directly. 


As it is possible to have more than one pointer in an AIX record, the length 
of such a record can vary. In extreme cases, it may be greater than the 
control interval length, and the record is treated as a spanned record. 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


1 AIXFG Flag byte 
XXXX XXX. Reserved 
“AIXPKP Prime key pointers are used 
RBA pointers are used 
AIXPL Pointer length (in binary) 


AIXPC Number of pointers in this record (in 
binary) 


AIXKL Length of alternate key (in binary) 
Note 1 AIXKY Alternate key 
Note 2 Note 3 AIXPT First pointer to base cluster 


Note 1: The length of this field is specified in AIXKL 
Note 2: The displacement of this field is 5 + the length of AIXKY 
Note 3: The length of this field is specified in AIXPL 





Figure 5.8 Alternate index record format 
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Catalog 


Purpose 


Structure 


VSAM employs two types of catalogs - the master catalog and user catalogs. 
The internal structure and format of the two types is identical; the only 
difference is that the master catalog contains an entry for each user catalog. 


The VSAM catalog is built and processed by catalog-management modules. 
Catalog-management modules, via the catalog, enable a user to locate a data 
set, volume, index, or cluster by specifying a name or volume serial number. 
In addition, the VSAM catalog provides VSAM with the information 
required to allocate space for data sets, verify authorization to gain access to 
them, compile usage statistics on them, and relate RBAs to physical loca- 
tions within data sets. The catalog indicates, therefore, much more than the 
simple location of data sets. The catalog maintains the relationship between 
a key-sequenced data set and its index, or between any data set and its 
alternate index(es), describes the location of VSAM data spaces and the data 
sets that reside in them, and describes the space that is available for new 
data sets. 


The VSAM catalog is conceptually a key-sequenced VSAM data set divided 
into two key ranges. VSAM data set processing options, as record replica- 
tion and sequence set with data, are utilized in both key ranges of the 
catalog. The catalog record size is 505 bytes in the low key range and 47 
bytes in the high key range; the catalog control interval size is 512 bytes. 
Figure 5.9 shows the VSAM catalog. The figure shows: 


e The low key range of the catalog, shown on the left, contains records 
that describe objects, that is, data sets, indexes, volumes, and clusters. 


e The high key range of the catalog, shown on the right, contains the true 
name (a data set name or volume serial number) of an object specified 
by the user. 


e The index, shown in the middle, points to both the low and high key 
ranges of the catalog. 


With the exception of catalog records that are built when the catalog is 
created and describe the catalog itself, catalog records are built as objects 
are cataloged. The order of the records depends upon which portion of the 
catalog the records belong to. If the catalog records reside in the low key 
range of the catalog, they are ordered according to control-interval number. 
As objects are cataloged, available control intervals are used. If the catalog 
records reside in the high key range of the catalog, they are ordered accord- 
ing to their true name (data-set name or volume serial number). 


Catalog management relies on record management for all record retrieval 
and storage. When a user specifies a data-set name, record management 
uses the index to retrieve a catalog record that contains the data-set name (in 
the high key range of the catalog); that record, in turn, contains the control- 
interval number of the catalog record that describes the data set. Catalog 
management converts the control-interval number to an RBA in the low key 
range of the catalog. 
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Low-key range High-key range 
catalog records true-name entries 


Figure 5.9 Parts of the VSAM catalog 


Catalog Records which Describe the Catalog 


Types of Catalog Records 


Catalog records that describe the catalog as a data set are in fixed positions 
at the beginning of the catalog. Figure 5.10 shows the control-interval 
numbers of records that describe the catalog, the kind of catalog record each 
is, and the contents of each. The various types of catalog record are de- 
scribed later in this section. 


Note that the self-describing records of the catalog do not contain CRA 
information (bytes 5-17). They do however use the release indicator (byte 
4). 

When the catalog is built, there are two True Name records. One contains 
the catalog’s volume serial number and points to control-interval 9. The 
other contains the catalog’s name and points to control-interval 2. 


There are various types of catalog records. They are shown below, grouped 
according to the key range of the catalog in which they are located. 
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Control 
Interval Record 
Number Type 


Data 


Index 
Cluster 


Control 


Extension 


Extension 


Extension 


Extension 


Extension 


Volume 


Volume 
Extension 


Contents 


Description of the data portion of the catalog (low and 
high key ranges) 


Description of the index portion of the catalog 


Description of the catalog as a key-sequenced VSAM 
cluster. This catalog record contains the catalog’s 
password information group occurrence. 


Catalog control record (CCR), which describes the 
catalog’s free control intervals within the low key 
range. 


Extension of the catalog-index record (control interval 
#1). This Extension record contains a description of 
the high-level index extents of the catalog. 


Extension of the catalog-data record (control interval 
#0). This Extension record contains a description of 
the low key range data extents of the catalog. 


Extension of the catalog-index record (control interval 
#1). For catalogs with embedded sequence-set re- 
cords, this Extension record contains a description of 
the index sequence-set extents for the low key range 
of the catalog. For non-imbedded catalogs, this record 
is marked as free. 


Extension of the catalog-data record (control interval 
#0). This Extension record contains a description of 
the extents of the True Name records in the high key 
range of the catalog. 


Extension of the catalog index record (control interval 
#1). For catalogs with embedded sequence-set re- 
cords, this Extension record contains a description of 
the index sequence-set extents for the high key range 
of the catalog. For non-imbedded catalogs, this record 
is marked as free. 


Description of the track allocation and VSAM data 
spaces on this volume. 


As many volume extension records as are necessary 
to describe the total space on the volume. 





Figure 5.10 Catalog records that describe the catalog 


High Key Range of the Catalog 


The high key range of the catalog contains 47-byte True Name records. The 
True Name records associate user-specified name or volume serial numbers 
with the control-interval number of the catalog record that describes the 


specified object. 


Low Key Range of the Catalog 


Each catalog record in this part of the catalog occupies a full control interval 
and each contains the number of the control interval in which it resides. 
Each catalog record also contains the record type of the record. The low key 
range of the catalog is made up of the following types of records: 


A: NonVSAM record, which describes a data set organized differently from 
VSAM. There is one nonVSAM record for each nonVSAM data set 
cataloged. Sometimes called ‘Alien’ record. 


C: Cluster record, which describes a VSAM data-set cluster. This record 
contains the control-interval number of a Data record and, if the VSAM 
data set is a key-sequenced data set, the control-interval number of an 
Index record. There is one Cluster record for each VSAM cluster cata- 


loged. 
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D: Data record, which describes the data component of a catalog, cluster, 
or AIX. There is one data record for each data set cataloged. 


E: Extension record, which contains overflow information from another 
catalog record (except type “V’). There are as many Extension records as 
are required to contain overflow information. 


F: Free record, which marks the control interval in which it resides as 
available for use as another kind of catalog record. There is one Free 
record for each previously assigned control interval that is available for 
use. 


G: Alternate Index record, which describes an alternate index. There is one 
such record for each alternate index cataloged. 


I: Index record, which describes the index component of a catalog, cluster, 
or AIX. There is one index record for each index cataloged. 


L: Control record, which describes the free control intervals in the low key 
range of the catalog. The Control record is the fourth record in the 
catalog. 


R: Path record, which describes a VSAM path. There is one such record for 
each path cataloged. 


U: User Catalog record, which describes a user catalog. One user catalog 
record is present in the master catalog for each user catalog which is 
cataloged. 


V: Volume record, which describes each VSAM data space on a volume, 
the data sets that reside in the data space, and the space available within 
the data space. There is one Volume record for each volume controlled 
by this catalog. 


W: Volume Extension record, which is used to extend volume records as 
required. 


Y: Upgrade set record, which describes an upgrade set. There is one such 
record for each upgrade set cataloged. 


Catalog Recovery Area 
For a catalog defined with the recovery attribute, a Catalog Recovery Area 
(CRA) is reserved on each volume owned by the catalog. The CRA on each 
volume is conceptually an entry-sequenced data set which contains a self- 
describing part similar to that of the catalog and copies of catalog records 
describing the data sets on the volume. These copies are immediately 
updated whenever the original records in the catalog are changed. 


Self-Describing Part of the CRA 
This part of the CRA contains those records which are necessary to de- 
scribe the CRA. They are basically the same records as those in the self- 
describing part of a catalog, except that the records describing an index are 
not needed, because the CRA is an entry-sequenced data set. The unused 
control intervals contain free records. Figure 5.11 shows the format of the 
self-describing part of the CRA. 
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Control 
interval Record 
number type Contents 


Description of the data portion of the CRA 


The field CRAVOL in this record contains the volume 
serial number of the catalog which owns the volume. 


Free record 


Cluster Description of the CRA as an entry-sequenced VSAM 
cluster. This record contains the name of the catalog 
which owns the volume. 


Control Catalog control record which describes the free control 
intervals in the CRA 


Free record 

Extension Extension of the CRA data record (CI#0) 
Free record 

Free record 

Free record 

Volume Description of the track allocation for the CRA 
Volume extension 

Volume extension Extensions of the volume record (CI#9) 
Volume extension 





Figure 5.11 Self-describing part of the CRA 


Copies of Catalog Records 


All catalog records which describe data sets or volumes are duplicated on 
specific volumes, as shown below: 


A volume record is duplicated in the CRA of the volume which it 
describes. 


All records concerning a key-sequenced data set or its alternate index 
(Cluster, Alternate Index, Data, Index, Path, and Upgrade Set records) 
are duplicated in the CRA of the first volume on which space was 
allocated for the index of the base cluster. 


All records concerning an entry-sequenced data set or its alternate 
index, or a relative record data set, (Cluster, Alternate Index, Data and 
Index for the AIX, Path, and Upgrade Set records) are duplicated on the 
first volume on which space was allocated for the data component of the 
base cluster. 


If a volume is imported from an OS/VS VSAM system, the CRA may 
contain other records, such as records which describe a nonVSAM data set. 
These records are not, however, used by VSE/VSAM. 
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Catalog Record Formats 


True-name Catalog Record 
The True Name record associates the volume serial number, data-set name, 
or cluster name specified by the user with the control-interval number of the 
catalog record that describes the object (volume, cluster, nonVSAM [alien] 
data set, data component, index component, path, or alternate index). True 
Name records are contained in the high key range part of the catalog and 
are pointed to by the catalog’s index records. The True Name record is 
retrieved using key-sequenced processing. The catalog-management mo- 
dules convert the control-interval number in the True Name record to an 
RBA which can be used to retrieve the associated record in the low key 
range. 


True Name records are 47 bytes long; several might be contained in a 
catalog’s control interval (512 bytes). The format of that record is shown in 
Figure 5.12. 


Offset 
Hex Dec Bytes Description 


Name of a data set or cluster, filled on the right with 


blanks, or a volume serial number, filled on the right with 
zeros, specified by the user. 


Control-interval number of the catalog record that 
describes the object. 





Figure 5.12 True-name catalog record format 
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NonVSAM Catalog Record 
The nonVSAM catalog record describes a nonVSAM data set. Figure 5.13 
shows the format of a nonVSAM catalog record. 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


Key and ID area 
Binary zeros 
ENTIDNO Control interval number of entry 


RELIND Release indicator; 
X‘00’ This record was created with a 
DOS/VS Release prior to Release 31. 
X‘01’ This record was created with 
DOS/VS Release 31 or later. 
CRAVOL CRA volume serial number 
CRAIDNO CRA control interval number 
CRADEVT CRA device type 
Binary zeros 
ENTYPE Record type - ‘A’ 


Length of information contained in 
record 


Number of variable-length fields that 
precede the pointer to an Extension re- 
cord. Always zero. 


Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
that follow displacement 92 (5C). This 
value is always equal to the displace- 
ment from the beginning of the record to 
the pointer to an Extension record. 


49 31 44 ENTNAME Entry name (data set name) 


The following six-byte entry contains control information for the group occurrence pointers 
that follow it 


93 5D 5 Pointer to Extension record. If this 
record is not continued in an Extension 
record, this field contains zeros. 


The number of group occurrence 
pointers that follow. 





Figure 5.13 NonVSAM catalog record format (part 1 of 2) 
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5.18 














Offset 
Dec Hex 


Bytes and 
Bit Pattern Field Name 








Description 





Group occurrence pointer (repetitive) 
Bit O and | of Byte 3 identify the group occurrence further: 


OOxx Xxxx Pointer to a group occurrence within the 
record. 


Byte 
0 Reserved 





























Meaning 


1-2 Displacement of the group 
occurrence from the beginning 
of all group occurrences in this 
record 


3 Bits O and 1 are set to zero. 
Bits 2 through 7 contain a code 
describing the group occur- 
rence pointed to. 


4 Sequence number of the group 
occurrence pointed to. 
10xx xXxxx Pointer to a group occurrence contained 


in an Extension record. 
Byte Meaning 


0-2 Control-interval number of the 
Extension record that contains 
this group occurrence. 


3 Bits 0 and 1 are set to 1 andO, 
respectively. Bits 2 through 7 
contain a code describing the 
group occurrence pointed to. 


4 Sequence number of the group 
occurrence pointed to. 
O1xx Xxxx Pointer to a group occurrence which has 


been deleted. 


The code in bits 2 through 7 of 
byte 3 and the sequence num- 
ber in byte 4 have been re- 
tained however. 


1 For further information see section Group occurrences in catalog records. 


Figure 5.13 NonVSAM catalog record format (part 2 of 2) 
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Cluster Catalog Record 


The Cluster record describes a data set and its index. Figure 5.14 shows the 
format of a cluster catalog record. 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


93 5D 
101 65 
104 69 
107 6B 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 


ENTYPE 


ENTNAME 


OWNERID 
DSETCRDT 
DSETEXDT 
CATTR 


Key and ID area 

Binary zeros 

Control interval number of entry 
Release indicator; 

X'00' This record was created with a 
DOS/VS Release prior to Release 31. 
X‘01’ This record was created with 
DOS/VS Release 31 or later. 

CRA volume serial number 

CRA Cl number 

CRA device type 

Binary zeros 

Record type - ‘C’ for a cluster record 
Record length 

Number of variable-length fields that 


precede the pointer to an Extension re- 
cord. Always zero. 


Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
that follow displacement 107 (6B). This 
value is always equal to the displace- 
ment from the beginning of the record to 
the pointer to an Extension record. 


Entry name (Normally true name of the 
cluster. If this record is in the self- 
describing part of the CRA, it contains 
the name of the catalog which owns this 
volume) 

Owner of data set 

Data set creation data (ydd) 

Data set expiration date (ydd) 

Reserved (for OS) 


The following six-byte entry contains control information for the group occurrence pointers 
that follow it.! 


108 6C 


Figure 5.14 
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Pointer to Extension record. If this 
record is not continued on an Extension 
record, this field contains zeros. 


The number of group occurrence 
pointers that follow. 





Cluster catalog record format (part 1 of 2) 
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Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


Group occurrence pointer (repetitive) 
Bit 0 and | of Byte 3 identify the group occurrence further: 


OOxx xxxx Pointer to a group occurrence within the 
record. 
Byte Meaning 
0 Reserved 
1-2 Displacement of the group 


occurrence from the beginning 
of all group occurrences in this 
record. 


3 Bits O and 1 are set to zero. 
Bits 2 through 7 contain a code 
describing the group occur- 
rence pointed to. 


4 Sequence number of the group 
occurrence pointed to by code. 
10xx XXXXx Pointer to a group occurrence contained 


in an Extension record. 

Byte Meaning 

0-2 Control-interval number of the 
Extension record that contains 
this group occurrence. 

3 Bits O and 1 are set to 1 and O, 
respectively. Bits 2 through 7 
contain a code that describes 
the group occurrence pointed 
to. 

4 Sequence number of the group 
occurrence pointed to by code. 

O1XxX XxXxx Pointer to a group occurrence which has 
been deleted. 
The code in bits 2 through 7 of 
byte 3 and the sequence num- 
ber in byte 4 have been re- 
tained however. 


1 For further information see section Group occurrences in catalog records. 


Figure 5.14 Cluster catalog record format (part 2 of 2) 
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Data and Index Catalog Record 


Data and Index records describe data sets and their indexes. Figure 5.15 
shows the format of the data and index records. 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


Key and ID area 
Binary zeros 
ENTIDNO Control interval number of entry 


RELIND Release indicator; 
X‘00O’ This record was created with a 
DOS/VS Release prior to Release 31. 
X‘01' This record was created with 
DOS/VS Release 31 or later. 


CRAVOL CRA volume serial number 
CRAIDNO CRA control interval number 
CRADEVT CRA device type 

Binary zeros 


ENTYPE Record type - 'D’ for a data record or ‘I’ 
for an index record 


Record length 


Number of variable-length fields that 
precede the pointer to an Extension re- 
cord. Always zero. 


Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
following displacement 142 (8E). This 
value is always equal to the displace- 
ment from the beginning of the record to 
the pointer to an Extension record. 


ENTNAME For a Data or Index record, the data-set 
name 


OWNERID Owner of the data set, specified when 
the data set was defined. 


DSETCRDT Data-set creation data, in packed- 
decimal form YDD, specified when the 
data set was defined. 


DSETEXDT Data-set expiration date, in packed- 
decimal form YDD, specified when the 
data set was defined. 


Data-set attributes, which are defined in 
Access Method Services commands, as 
follows: 


Speed - recovery features will be 
minimized or omitted in order to optimize 
operating speed during initial loading 
Unique component. Entire space occu- 
pied by a unique component. 

Reusable data set 

Erase the component upon deletion 
Recoverable catalog 

Inhibit update 

This component has been temporarily 
exported 

Reserved for OS/VS MVM 





Figure 5.15 Data and index catalog record format (part 1 of 4) 
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Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


Data-set sharing attributes as follows: 
Cross-partition sharing: 


The data set can be shared by READ 
users or it can be used by one 
UPDATE/OUTPUT user. 

The data set can be shared by READ 
users and one UPDATE/OUTPUT user. 
The data set can be fully shared 

The data set can be fully shared; with 
assistance supplied by VSAM. 
Cross-system sharing (set by DOS but 
used only by OS): 

The data set can be shared by READ 
users or it can be used by one 
UPDATE/OUTPUT user. 


The data set can be shared by READ 
user and one UPDATE/OUTPUT user. 
The data set can be fully shared 

The data set can be fully shared; with 
assistance supplied by VSAM. 


NOALLOCATION cluster 
DS not usable 
Reserved 


OPENIND Open indicator flag; if this byte contains 
X‘80’, the data set is open for output. 

BUFSIZE Minimum buffer size 

PRIMSPAC Primary space allocated for the data set 
or index, specified when the data set or 
index was defined. 


SCONSPAC Secondary space allocation for the data 
set or index, specified when the data set 
or index was defined. 
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Bytes and 
Bit Pattern Field Name 


SPACOPTN 


HURBADS 
HARBADS 


LRECL 


133 85 USERINFO 


135 87 8 EXCPEXIT 


Description 


Space options flags. 


Track request, which indicates that 
space was allocated in terms of tracks. 
Cylinder request, which indicates that 
space was allocated in terms of cylin- 
ders. 

Secondary allocation class same as 
primary allocation class. (Cluster, AIX) 
Use class-0 for secondary allocation 
Data set in class-O space. 

Data set in class-1 space. 

Data set in class-2 space 

Data set in class-3 space . 

Data set in class-4 space 

Data set in class-5 space 

Data set in class-6 space 

Data set in class-7 space. 

Reserved. 


High used RBA of the data set or index. 


High allocated RBA of the data set or 
index. 


For a Data record, the logical record size 
of the data set described by this Data 
record. For an Index record, always 
X'FF's. 

User information for the ISAM interface 
program (IIP). 


Exception exit 


The following six-byte entry contains control information for the group occurrence pointers 
that follow it.' 


143 8F 5 


Pointer to Extension record. If this 
record is not continued in an Extension 
record, this field contains zeros. 


The number of group occurrence 
pointers that follow. ! 


Group occurrence pointer (repetitive) 


Bit 0 and | of Byte 3 identify the group occurrence further: 


OOxx Xxxx 


Pointer to a group occurrence within the 
record 


Byte Meaning 
0 Reserved 


1-2 Displacement of the group 
occurrence from the beginning 
of all group occurrences in this 
record. 


Bits O and 1 are set to zero. 
Bits 2 through 7 contain a code 
that describes the group occur- 
rence pointed to. 


Sequence number of the group 
occurrence pointed to. 
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Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


10xx xXxxx Pointer to a group occurrence contained 
in an Extension record. 


Byte Meaning 


0-2 Control-interval number of the 
Extension record that contains 
this group occurrence. 


3 Bits O and 1 are set to 1 and O, 
respectively. Bits 2 through 7 
contain a code that describes 
the group occurrence pointed 


to. 
4 Sequence number of the group 
occurrence pointed to by code. 
O1XxxX XXXX Pointer to a group occurrence which has 


been deleted. 


The code in bits 2 through 7 of 
byte 3 and the sequence num- 
ber in byte 4 have been re- 
tained however. 

! For further information see section Group occurrences in catalog records. 


Figure 5.15 Data and index catalog record format (part 4 of 4) 


Extension Catalog Record 
The Extension record contains overflow information from another catalog 
record. Figure 5.16 shows the format of an extension catalog record. 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


Key and ID area 
Binary zeros 
ENTIDNO Control interval number of entry 


RELIND Release indicator; 
X‘00’ This record was created with a 
DOS/VS Release prior to Release 31 
X‘01' This record was created with 
DOS/VS Release 31 or later 


CRAVOL CRA volume serial number 
CRAIDNO CRA control interval number 
CRADEVT CRA device type 

Binary zeros 


ENTYPE Record type - ‘E’, for an extension of any 
other record except a volume catalog 
record where record type is ‘W’. 


Record length 
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Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


Number of variable-length fields that 
precede the pointer to an Extension re- 
cord. Always zero. 


Length of the fixed-length fields in the 
header fields, excluding any fixed length 
fields following displacement 48 (30). 
This value is always equal to the dis- 
placement from the beginning of the re- 
cord to the extension record's pointer. 


The following six-byte entry contains control information for the group occurrence pointers 
that follow it.! 


49 31 5 Pointer to Extension record. If this 
record is not continued on an Extension 
record, this field contains zeros. 


The number of group occurrence 
pointers that follow. 


Group occurrence pointer (repetitive) 
Bit 0 and | of Byte 3 identify the group occurrence further: 


OOxx Xxxx Pointer to a group occurrence within the 
record. 


Byte Meaning 
O Reserved 


1-2 Displacement of the group 
occurrence from the beginning . 
of all group occurrences in this 
record. 


Bits O and 1 are set to zero. 
Bits 2 through 7 contain a code 
describing the group occur- 
rence pointed to. 


4 Sequence number of the group 
(4-5)2 occurrence pointed to be code. 


1Oxx XXXX Pointer to a group occurrence contained 
in an Extension record. 


Byte Meaning 


0-2 Control-interval number of the 
Extension record that contains 
this group occurrence. 


Bits O and 1 are set to 1 and O, 
respectively. Bits 2 through 7 
contain a code that describes 
the group occurrence pointed 
to. 


4 Sequence number of the group 
(4-5)2 occurrence pointed to be code. 


O1Xxx XxXxXXx Pointer to a group occurrence which has 
been deleted. 


The code in bits 2 through 7 of 
byte 3 and the sequence num- 
ber in bytes 4 and 5 of ‘W’ type 
have been retained however. 

For further information see section Group occurrences in catalog records. 


For ‘W' type records, this sequence number occupies bytes 4 and 5, and the 
group occurrence pointer is 6 bytes long. 





Figure 5.16 Extension catalog record format (part 2 of 2) 


Licensed Material —- Property of IBM Section 5. Data Areas 5.25 


Free Catalog Record 


The Free record indicates that the control interval in which it resides is free 
and points to the next control interval that is free because of deletion. Note 
that the free space in the catalog that has never been assigned is not repre- 
sented by a Free record; a Free record is used only to mark a record that was 
used and deleted. Figure 5.17 shows the format of the free record. 


Bytes Description 


Key. 
Byte Meaning 


O Zeros. 

1-3 Control-interval number of this record 
4-43 Zeros 

Record type - ‘F’. 





Control-interval number of the next free control interval 


Figure 5.17 Free catalog record format 


5.26 VSE/VSAM VSAM Logic, Volume | Licensed Material — Property of IBM 


Alternate Index Catalog Record 


The alternate index catalog record describes the alternate index as a key- 
sequenced data set and relates it to the base cluster it belongs to. Figure 5.18 
shows the format if the alternate index catalog record. 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


Key and ID area 
Binary zeros 
ENTIDNO Control interval number of entry 


RELIND Release indicator; 
X'00' This record was created with a 
DOS/VS Release prior to Release 31 
X‘01' This record was created with 
DOS/VS Release 31 or later 


CRAVOL CRA volume serial number 
CRAIDNO CRA control interval number 
CRADEVT CRA device type 

Binary zeros 
ENTYPE Record type - 'G’ 

Record length 


Number of variable-length fields that 
precede the pointer to an Extension re- 
cord. Always zero. 
Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
that follow displacement 107 (6B). This 
value is always equal to the displace- 
ment from the beginning of the record to 
the pointer to an Extension record. 

49 31 ENTNAME Entry name (data set name) 

93 5D OWNERID Owner of data set 

101 65 DSETCRDT Data set creation date (ydd) 

104 69 DSETEXDT Data set expiration date (ydd) 


107 6B RGATTR AIX attribute, X‘80’ = upgrade (AIX) 


The following six-byte entry contains control information for the group occurrence pointers 
that follow it." 


108 6C 5 Pointer to Extension record. lf this 
record is not continued on an Extension 
record, this field contains zeros. 


The number of group occurrence 
pointers that follow. 
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Index Catalog Record 


Offset Bytes and 


Dec Hex Bit Pattern Field Name Description 


Group occurrence pointer (repetitive) 
Bit 0 and | of Byte 3 identify the group occurrence further: 


OOxx Xxxx Pointer to a group occurrence within the 
record. 
Byte Meaning 
6) Reserved 
1-2 Displacement of the group 
occurrence from the beginning 
of all group occurrences in this 
record. 
3 Bits O and 1 are set to zero. 
Bits 2 through 7 contain a code 
that describes the group occur- 
rence pointed to. 
4 Sequence number of the group 
occurrence pointed to. 
10xx xXxxx Pointer to a group occurrence contained 
in an Extension record. 
Byte Meaning 
0-2 Control-interval number of the 
Extension record that contains 
this group occurrence. 
3 Bits O and 1 are set to 1 and O, 
respectively. Bits 2 through 7 
contain a code that describes 
the group occurrence pointed 
to. 
4 Sequence number of the group 
occurrence pointed to by code. 
O1Xxx XXXxX Pointer to.a group occurrence which has 


been deleted. 


The code in bits 2 through 7 of 
byte 3 and the sequence num- 
ber in byte 4 have been re- 
tained however. 


1 For further information see section Group occurrences in catalog records. 


Figure 5.18 Alternate index catalog record format (part 2 of 2) 


For index catalog record format see data catalog record format. The record 
type (byte 44) is ‘T’. 


Catalog Control Record (CCR) 
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The catalog control record (CCR) is used by catalog management to control 
the allocation of control intervals in the low key range of the catalog, where 
catalog records, excluding the True Name records and the index, reside. 
The CCR also shows the catalog’s high-used and high-allocated RBA 
values. The catalog control record is the fourth record (control interval) in 
the catalog. 


For a request of one catalog record, catalog management tries to use a 
record that was freed because of deletion. This process is done before using 
unassigned space. If more than one catalog record is needed, catalog man- 
agement tries to use contiguous unassigned space in the current extent; if 
sufficient unassigned space is not available, records that have been deleted. 
are used. Figure 5.19 shows the CCR format. 
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Offset . 
Dec Hex Description 


Key 
Byte Meaning 
0 Zeros. 
1-3 Control-interval number of this record. 
4-43 Zeros. 
44 2C Record type - ‘L’. 


45 2D Number of the highest control interval within the current 
extent.! 


48 30 Number of the next free control interval of those that 
have not been previously assigned. ! 


51 33 Count of deleted control intervals, that is, the count of 
control intervals that are free because of deletion.2 


54 36 3 First deleted control interval in a chain of control inter- 
vals that are free because of deletion.2 


The following fields are used to keep track of the RBA values that denote the current logical 
end of parts of the catalog: 


57 39 
61 3D 
65 41 
69 45 
73 = 49 
77 =6©°4D 
81 51 
85 55 
89 59 
93 5D 
97 = 

65 


Data, low key range: high-key RBA 

Data, low key range: high-used RBA 

Data, low key range: high-allocated RBA 

Data, high key range: high-key RBA 

Data, high key range: high-used RBA 

Data, high key range: high-allocated RBA 

Index, high level: high-used RBA 

Index, high level: high-allocated RBA 

Index, low key range - sequence set: high-used RBA 
index, low key range - sequence set: high-allocated RBA 
Index, high key range - sequence set: high-used RBA 


index, high key range - sequence set: high-allocated 
RBA 


This field is used to keep track of unassigned space within the current extent. 


This field is used to keep track of previously-used records that are now 
available for use as another catalog record. 


Pp ph hhh PA HHA 





Figure 5.19 Catalog control record format 
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Path Catalog Record 
The path catalog record describes a VSAM-path which is a logical connec- 
tion between a base cluster and an alternate index. Figure 5.20 shows the 
format of the path catalog record. 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


49 31 
93 5D 
101 65 
104 69 
107 6B 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 


ENTYPE 


ENTNAME 
OWNERID 
DSETCRDT 
DSETEXDT 
RGATTR 


Key and ID area 
Binary zeros 
Control interval number of entry 


Release indicator; 

X'00’ This record was created with a 
DOS/VS Release prior to Release 31 
X‘'01’ This record was created with 
DOS/VS Release 31 or later 


CRA volume serial number 
CRA control interval number 
CRA device type 

Binary zeros 

Record type - ‘R’ 

Record length 


Number of variable-length fields that 
precede the pointer to an Extension re- 
cord. Always zero. 

Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
following displacement 107 (6B). This 
value is always equal to the displace- 
ment from the beginning of the record to 
the pointer to an Extension record. 
Entry name (data set name) 

Owner of data set 

Data set creation date (ydd) 

Data set expiration date (ydd) 

Path attribute, X‘80’ = update (path) 


The following six-byte entry contains control information for the group occurrence pointers 
that follow it.4 


108 6C 


Pointer to Extension record. If this 
record is not continued on an Extension 
record, this field contains zeros. 


The number of group occurrence 
pointers that follow. 
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Offset 






Figure 5.20 
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Bytes and 


Dec Hex Bit Pattern Field Name 










OOxx Xxxx Pointer to a group occurrence within the 
record. 
Byte Meaning 
6) Reserved 
1-2 Displacement of the group 
occurrence from the beginning 
of all group occurrences in this 
record. 
3 Bit O and 1 are set to zero. Bits 
2 through 7 contain a code that 
describes the group occur- 
rence pointed to. 
4 Sequence number of the group 
occurrence pointed to. 
1OxX XXxx Pointer to a group occurrence contained 


in an Extension record 


Byte 
0-2 


4 


O1XxX XXXX Pointer to a group occurrence which has 
been deleted. 


1 For further information see section Group occurrences in catalog records. 


Path catalog record format (part 2 of 2) 


Description 


Group occurrence pointer (repetitive) 
Bit 0 and | of Byte 3 identify the group occurrence further: 


























Meaning 


Control-interval number of the 
Extension record that contains 
this group occurrence. 


Bits O and 1 are set to 1 and O, 
respectively. Bits 2 through 7 
contain a code that describes 
the group occurrence pointed 
to. 


Sequence number of the group 
occurrence pointed to by code. 


The code in bits 2 through 7 of 
byte 3 and the sequence num- 
ber in byte 4 have been re- 
tained however. 
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User-Catalog Catalog Record 


This record can only occur in the VSAM master catalog. It describes a user 
catalog. Figure 5.21 shows the format of the user-catalog catalog record. 


Offset 
Dec Hex 
6) 6) 
0 0 
1 1 
4 4 
5 5 
11 B 
14 E 
18 12 
44 2C 
45 2D 
47 oF 
48 30 
49 31 


Bytes and 


Bit Pattern Field Name 


44 
1 
3 
1 


44 


ENTIDNO 
RELIND 


CRAVOL 
CRAIDNO 
CRADEVT 


ENTYPE 


ENTNAME 


Description 


Key and ID area 
Binary zeros 
Control interval number of entry 


Release indicator; 

X‘00’ This record was created with a 
DOS/VS Release prior to Release 31 
X‘01' This record was created with 
DOS/VS Release 31 or later 


CRA volume serial number 
CRA control interval number 
CRA device type 

Binary zeros 

Record type - ‘U' 

Record tength 


Number of variable-length fields that 
precede the pointer to an Extension re- 
cord. Always zero. 


Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
following displacement 92 (5C). This 
value is always equal to the displace- 
ment from the beginning of the record to 
the pointer to an Extension record. 


Entry name (data set name) 


The following six-byte entry contains control information for the group occurrence pointers 


that follow it.! 
5D 


93 


98 


62 


5 


Pointer to Extension record. If this 
record is not continued on an Extension 
record, this field contains zeros. 


The number of group occurrence 
pointers that follow.! 


Group occurrence pointer (repetitive) 


Bit 0 and 1 of Byte 3 identify the group occurrence further: 


Figure 5.21 
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OOxx xxxx 


Pointer to a group occurrence within the 
record. 


Byte Meaning 
0 Reserved 


1-2 Displacement of the group 
occurrence from the beginning 
of all group occurrences in this 
record. 


3 Bit O and 1 are set to zero. Bits 
2 through 7 contain a code that 
describes the group occur- 
rence pointed to. 


4 Sequence number of the group 
occurrence pointed to. 


User-catalog catalog record format (part 1 of 2) 
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Offset 
Dec Hex 


Bytes and 
Bit Pattern Field Name 





Description 





1O0xx XXXX Pointer to a group occurrence contained 
in an Extension record. 


Byte Meaning 

0-2 Control-interval number of the 
Extension record that contains 
this group occurrence. 

3 Bits O and 1 are set to 1 and O, 
respectively. Bits 2 through 7 
contain a code that describes 
the group occurrence pointed 


to. 
4 Sequence number of the group 
occurrence pointed to by code. 
O1XX XXxXx Pointer to a group occurrence which has 


been deleted. 


The code in bits 2 through 7 of 
byte 3 and the sequence num- 
ber in byte 4 have been re- 
tained however. 


1 For further information see section Group occurrences in catalog records. 


Figure 5.21 User-catalog catalog record format (part 2 of 2) 


Volume Catalog Record 
The Volume record describes VSAM data spaces, their extents, and the data 
sets that reside in VSAM data spaces. Figure 5.22 shows the format of the 
volume record. 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 
Key and ID area 
Binary zeros 
ENTIDNO Control interval number of entry 


RELIND Release indicator; 
X'00’ This record was created with a 
DOS/VS Release prior to Release 31. 


X'01' This record was created with 
DOS/VS Release 31 or later. 


CRAVOL CRA volume serial number 
CRAIDNO CRA control interval number 
CRADEVT CRA device type 

Binary zeros 
ENTYPE Record type - ‘V’ 

Record length 





Figure 5.22 Volume catalog record format (part 1 of 3) 


Licensed Material — Property of IBM Section 5. Data Areas 5.33 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


Number of variable-length fields that 
precede the pointer to an Extension re- 
cord. Always zero. 


Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
following displacement 126 (7E). This 
value is always equal to the displace- 
ment from the beginning of the record to 
the pointer to an Extension record. 


ENTNAME Volume serial number, filled with binary 
zeros on the right, of the volume de- 
scribed by this record. 


VOLTSTMP Volume time stamp, which indicates the 
time-of-day clock value when space was 
last added to, or deleted from, this vol- 
ume. 


VOLDVCHR Device characteristics. 
Byte Meaning 
0-3 Volume device type. 
4-7 Maximum device blocksize. 


8-9 Number of cylinders on this 
volume. 


10-11 Number of tracks per cylinder 
on this volume. 


12-13 | Number of bytes per track on 
this volume. 


14 Number of bytes required for 
gaps and check bits for each 
keyed block other than the last 
block on a track for this 
volume.! 


Number of bytes required for 
gaps and check bits for the last 
keyed block on a track for this 
volume. ! 


Number of bytes to be sub-, 
tracted for a block that is not 
keyed. 


Flags: 
Block overhead for keyed 
records is a two-byte field 
(bytes 15 and 16. 
Use tolerance factor (bytes 18 
and 19) on all blocks except 
the last block to calculate the 
effective length of a block.! 
XXXX .XX. Reserved. 
1 VOLRFLG Volume record flags 


1 SYSEXTDS Number of extents per suballocation- 
request allowed by the system. 


4 Space in the catalog record into which 
the following 4 bytes of derived informa- 
tion will be moved (in the buffer) if re- 
quested. 
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Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


The following field names identify information that is not contained in the volume catalog 
record, the information is derived from the group occurrences in the volume catalog record and 
will be placed in the buffer if requested: 


123 7B 2 NODSPACE Number of data spaces on the volume - a 
count of the Data Space Group occur- 
rences. 

125 7D 2 NODSET Number of data sets on the volume - a 


count of the Data Set Directory Entry 
group occurrences. 


The following six-byte entry contains control information for the group occurrence pointers 
that follow it.! 


127 7F 5 Pointer to Extension record. If this 
record is not continued on an Extension 
record, this field contains zeros. 


132 84 1 Number of group occurrence pointers 
that follow. 


Group occurrence pointer (repetitive) 
Bit 0 and | of Byte 3 identify the group occurrence further: 


OOxx xxxx Pointer to a group occurrence within the 
record. 
Byte Meaning 
6) Reserved. 
1-2 Displacement of the group 


occurrence from the beginning 
of all group occurrences in this 
record. 


3 Bits O and 1 are set to zero. 
Bits 2 through 7 contain a code 
describing the group occur- 
rence pointed to. 


4-5 Sequence number of the group 
occurrence pointed to. 
10Oxx XXxX Pointer to a group occurrence contained 


in an Extension record. 
Byte Meaning 


0-2 Control-interval number of the 
Extension record that contains 
this group occurrence. 


3 Bits O and 1 are set to 1 and O, 
respectively. Bits 2 through 7 
contain a code that describes 
the group occurrence pointed 
to. 


4-5 Sequence number of the group 
occurrence pointed to. 


1 For further information see section Group occurrences in catalog records. 


Figure 5.22 Volume catalog record format (part 3 of 3) 


Volume Extension Catalog Record 


For this format see extension catalog record format. The record type (byte 
44) is ‘W’. Note that the Group occurrence pointers in a ‘W’ type record are 
6 bytes long, similar to those in a ‘V’ type record. 
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Upgrade Set Catalog Reco 


5.36 


rd 


An upgrade set catalog record describes an AIX in the upgrade set which is 
the group of alternate indexes belonging to a base cluster which are to be 
updated automatically. Figure 5.23 shows the format of the upgrade set 


catalog record. 


Offset Bytes and 

Dec Hex Bit Pattern Field Name 
0 0 44 
0 0 1 
1 1 3 ENTIDNO 
4 4 1 RELIND 
5 5 6 CRAVOL 
11 B 3 CRAIDNO 
14 +E 4 CRADEVT 
18 12 26 
44 2C 1 ENTYPE 
45 2D 2 
47 2F 1 
48 30 1 


Description 


Key and ID area 
Binary zeros 
Control interval number of entry 


Release indicator; 

X'00’ This record was created with a 
DOS/VS Release prior to Release 31 
X‘01' This record was created with 
DOS/VS Release 31 or later 


CRA volume serial number 
CRA control interval number 
CRA device type 

Binary zeros 

Entry type - ‘Y’ 

Record length 


Number of variable-length fields that 
precede the pointer to an Extension re- 
cord. Always zero. 


Length of the fixed-length fields in this 
record, excluding any fixed-length fields 
following displacement 48 (30). This 
value is always equal to the displace- 
ment from the beginning of the record to 
the pointer to an Extension record. 


The following six-byte entry contains control information for the group occurrence pointers 


that follow it. 
49 31 5 
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Pointer to Extension record. If this 
record is not continued on an Extension 
record, this field contains zeros. 


The number of group occurrence 
pointers that follow. 


Upgrade set catalog record format (part 1 of 2) 


Licensed Material — Property of IBM 














Offset 
Dec Hex 


Bytes and 
Bit Pattern Field Name 







Description 





Group occurrence pointer (repetitive) 
Bit 0 and | of Byte 3 identify the group occurrence further: 


OOxx Xxxx Pointer to a group occurrence within the 
record. 


























Byte Meaning 
0 Reserved. 
1-2 Displacement of the group 


occurrence from the beginning 
of all group occurrences in this 
record. 


3 Bits O and 1 are set to zero. 
Bits 2 through 7 contain a code 
that describes the group occur- 
rence pointed to. 


4 Sequence number of the group 
occurrence pointed to. 


1OxxX Xxxx Pointer to a group occurrence contained 
in an Extension record. 


Byte Meaning 
0-2 Control-interval number of the 


Extension record that contains 
this group occurrence. 


3 Bits O and 1 are set to 1 and O, 
respectively. Bits 2 through 7 
contain a code that describes 
the group occurrence pointed 


to. 
4 Sequence number of the group 
occurrence pointed to by code. 
O1XxX XXXX Pointer to a group occurrence which has 


been deleted. 


The code in bits 2 through 7 of 
byte 3 and the sequence num- 
ber in byte 4 have been re- 
tained however. 


1 For further information see section Group occurrences in catalog records. 


Figure 5.23 Upgrade set catalog record format (part 2 of 2) 


Group Occurrences in Catalog Records 


Group occurrences are fields of related information within a catalog record 
which are grouped together so that they can be treated as a unit. For exam- 
ple, all fields relating to a volume on which a data set resides are located in 
one group occurrence. There is one group occurrence for each volume 
concerned. Thus, if a data set resides on three volumes, there are three 
group occurrences, which are not necessarily contiguous. 


The group occurrences are found by means of group occurrence pointers in 
the catalog record. These pointers also contain a code which identifies the 
type of group occurrence to which they point. The pointers are grouped in 
such a way that all pointers to a particular type of group occurrence are 
together. In the example above, the pointers to the three volume informa- 
tion group occurrences would be contiguous, even if the group occurrences 
are not. 
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Group Occurrences in Extension Records 


5.38 


This description is designed to show the steps involved in building the group 
of records shown in Figure 5.24. The numbers in parentheses in the descrip- 
tion refer to the record numbers in Figure 5.24. Initially, when the base 
record (1) is created, the group occurrence pointers (GOPs) and group 
occurrences (GOs) are placed in the base record. As further GOs and GOPs 
are added, the available space becomes insufficient and the base record 
must be extended. 


This is done by means of a vertical chain of extension records. GOs are 
moved out of the base record (1) into an extension record (2) to create space 
for GOPs. If necessary, further extension record(s) (3) can be added to this 
vertical chain. The GOs in the extension records are located by means of 
two GOPs: the first GOP, in the base record, points to the extension record, 
where a second GOP with the same group code and sequence number as the 
first, points to the associated GO within the extension record. 


Later, the GOPs in the base record may require more space than is avail- 
able, although all GOs have been moved to the vertical chain. In this case, 
the base record (1) is extended by a horizontal chain. The first record in the 
horizontal chain(4) is located by means of the extension pointer in the base 
record (1). This extension record (4) is now treated similarly to the original 
base record. It first contains both GOPs and GOs, then extended with 
records in a vertical chain (5,6,8), and finally extended horizontally (9). 


If it becomes nécessary to store a GO which will not fit into a single record, 
a pseudo-horizontal chain becomes necessary. If this is required within a 
vertical chain (6), the extension record (7) is simply chained with the aid of 
the extension pointer in the record containing the first part of the GO (6). 


A pseudo-horizontal chain is however, not allowed within the horizontal 
chain (1,4,9). Thus, if an overlong GO is encountered at a time where the 
last record in the horizontal chain (9) still contains GOPs, GOs, and free 
space (which means that the next GO would normally be placed in this 
record) an artificial vertical chain (10) must first be built. This can the be 
extended in the form of a pseudo-horizontal chain (10,11) to hold the GO. 
The first record in a pseudo-horizontal chain always contains an extension 


pointer to the second record and always has a GOP count of |, because such 
a “spanned” GO may not share a record with any other GO. 
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GO: Group occurrence 


E: Extension pointer field 


N: GOP count field — | Y GOP: Group occurrence pointer 
n: Actual GOP count 8 a Lo | n |cors| cos| GO...GO: Overlength GO (in 2 parts) 
Record 1: Base record, containing GOPs pointing to records 2 and 3 (vertical pointers) and an extension pointer to record 4 


(horizontal pointer). 


Record 2: Extension record, containing GOs from record 1 : ; 
Record 3: _ Extension record, containing GOs from record 1 4 Vertical chain 


Record 4: Extension record in the horizontal chain, containing further GOPs pointing to records 5, 6, and 8 (vertical pointers) and 
an extension pointer to record 9 (horizontal pointer). 


Record 5: Extension record containing GOs from record 4 

Record 6: Extension record containing 1st part of long GO Pseudo Vertical 

Record 7: Extension record containing 2nd part of long GO | chain chain 

Record 8: Extension record containing GOs from record 4 

Record 9: Extension record containing further GOPs and GOs (last record in the horizontal chain). 


Record 10: Extension record containing ist part of long GO Artificial vertical chain 
Record 11: Extension record containing 2nd part of long GO | with pseudo-horizontal chain 


Figure 5.24 Group occurrences in extension records. 
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Types of Group Occurrences 


The following list shows the various types of group occurrences, and the 
types of catalog records in which they can occur. Note that it is possible for 
one catalog record to contain many group occurrences. 


e AMDSB (Access Method Data Set Statistics Block), which appears in 
Data and Index records. Only one copy of an AMDSB appears in a 
record. A pointer to AMDSB information contains a code of 1. 


e Association information, which occurs in Data, Index, Cluster, Alter- 
nate Index, Path, and Upgrade Set records. For further details, see 
Association Group Occurrences later in this section. A pointer to associa- 
tion information contains a code of 2. 


¢ Volume information, which appears in Data, Index, User Catalog, and 
non-VSAM records. This group occurrence describes all of the direct- 
access device space allocated to the data set (or index, etc.) on a particu- 
lar volume. A separate set of volume information fields is used to de- 
scribe the total space on each volume. If the data set’s space on a vol- 
ume is divided into key ranges, each key range is described in a separate 
set of volume-information fields. As many sets of volume-information 
fields as are required to describe allocated space can appear. A pointer 
to volume information contains a code of 3. 


e Password information, which can appear in Data, Index, Path, Cluster 
and Alternate index records. This group occurrence contains the securi- 
ty information for a data set (or index, etc.). Only one set of password- 
information fields can appear. A pointer to password information 
contains a code of 4. 


The following group occurrences occur only in Volume catalog records. 


e Space map group occurrence. This group occurrence describes each 
track on the volume as allocated to a VSAM object or unallocated. Each 
volume record contains as many group occurrences as are necessary to 
reflect the total space on the volume. A pointer to track allocation 
information contains a code of 5. 


e Data space group occurrence. This group occurrence describes a VSAM 
data space on the volume. One group occurrence is required to describe 
each data space and its extents on the volume. A pointer to data-space 
information contains a code of 6. 


e Data set directory entry group occurrence. This group occurrence 
describes a data set that resides in a VSAM data space. One group 
occurrence is required for each data set. A pointer to data-set informa- 
tion contains a code of 8. 


Association Group Occurrences 


These group occurrences identify the relationships between the various 
records which describe a data set and its associated components. 


Each Cluster, Data, Index, Alternate index, Path, or Upgrade Set catalog 
record can contain one or more association group occurrences, depending 
on the overall configuration of the data set. 


Figure 5.25 shows a possible configuration for a data set which uses all 
possible association group occurrences. It consists of a key-sequenced data 
set (base cluster), an alternate index which belongs to the upgrade set, and 
two paths. Path | is defined over the base cluster and serves as an ‘alias’, 
while path 2 is defined over the AIX and is used to address the AIX/base 
cluster combination. 
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The arrows in the figure represent the ‘direction’ of the pointers in the group 
occurrences. For example, the base cluster record and the path | record 
contain pointers to each other. The path | record, however, points only to 
the base index and data records; there is no ‘backward’ pointer from these 
records to the path record. 
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Figure 5.25 Association group occurrences 


Figure 5.25 shows at least one of each type of association group occurrence. 
If, however, the data set configuration contains more alternate indexes, 
paths, etc. there will be correspondingly more association group occurrences 
which point to the additional components. The base cluster record, for 
example, will have an association group occurrence pointing to each alter- 
nate index record. 
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Group Occurrence Formats 
The following section shows the format of each type of group occurrence. 


AMDSB Group Occurrence 
The AMDSB group occurrence contains a copy of the AMDSB control 
block, and is updated each time the data set is closed. This group occurrence 


is associated with a pointer that contains a group code of |. Figure 5.26 
shows the AMDSB format. 


Field 
Size Field Name Description 


Control information 
Byte Meaning 


(@) Count of the number of variable fields in this 
group occurrence 


Hexadecimal displacement to the first variable- 
length field from the beginning of this group 
occurrence 


AMDSBCAT AMDSB. Only the first 96 bytes of the AMDSB are 
cataloged. The remainder are ignored. See description 
and format of AMDSB for detailed information, except for 
the following special case in the AMDSBs of an AIX. 


The field at offset 4 of the index AMDSB and of the 
group occurrence is referenced with the name AMD- 
NEST and contains the number of entries in an index 
section. 


In the data AMDSB group occurrence, this field is called 
AMDAXRKP and contains the relative key position (in the 
base cluster record) for this AIX. 


When the AMDSB group occurrences are transferred to 
the AMDSBs at OPEN time, the contents of AMDAXRKP 
are moved to field AMDAIRKP (at offset 118 decimal) 
and the field at offset 4 (now again called AMDNEST) is 
loaded with the contents of AMDNEST from the index 
AMDSB. 


Note that this movement of data is carried out by OPEN 
for all AMDSBs, even through the fields may be empty, 
or already contain the correct information. 





Figure 5.26 AMDSSB group occurrence format 
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Association Group Occurrence 
The control interval number of a related record is contained in an associa- 


tion group occurrence. This group occurrence is associated with a pointer 
which contains a group code of 2. Figure 5.27 shows the format. 


Field 
Size Field Name Description 


Control information 
Byte Meaning 


(0) Count of the number of variable fields in this 
group occurrence 


Hexadecimal displacement to the first variable- 
length field from the beginning of this group 
occurrence 


if this entry describes a Data record 
if this entry describes an Index record 
if this entry describes a Ciuster record 
if this entry describes an Alternate Index record 
if this entry describes a Path record 
if this entry describes an Upgrade Set record 
3 NAME Control interval number of the record specified above 


The following fields are present only in an association group occurrence located in an Upgrade 
Set Record) 


1 TYPE2 ‘|’ This entry can describe only an Index record 
3 NAME2 Control interval number of the Index record 


1 Each association group occurrence in an Upgrade Set record describes the 
data component (TYPE, NAME) and the index component (TYPE2, NAME2) of 
an alternate index. 





Figure 5.27 Association group occurrence format 


Volume Information Group Occurrence 


All extents allocated to the data set, index, or data set’s key range on a 
volume are described by a volume information group occurrence. This 
group occurrence is associated with a pointer that contains a group code of 
3. Figure 5.28 shows its format. 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


ENTVOL Control information 
Byte Meaning 


O Count of the number of variable 
fields in this group occurrence 


Hexadecimal displacement to 


the first variable-length field 
from the beginning of this 
group occurrence. 

DEVTYP Device type 


VOLSER Volume serial number 


FILESEQ File sequence number. (This field is 
used for nonVSAM data sets that reside 
on tape volumes.) 





Figure 5,28 Volume information group occurrence format (part 1 of 2) 
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5.44 


Offset 
Dec Hex 


Bytes and 


Bit Pattern Field Name 


oeeX XXX 


VOLFLG 


Description 


Volume flags, as follows: 


Prime, which indicates that this volume 
was allocated when the data set was de- 
fined or that a data set that is not divided 
into parts according to key has been ex- 
tended to this volume. 

Candidate, which indicates that this 
volume is available for use by the data 
set described by this record. 

Overflow, which indicates that this 
volume is being used by a data set that is 
divided into parts according to key, but 
this volume was not allocated when the 
data set was defined. 

Reserved 


The following fields are used only in data and index records 


15 


16 


20 
24 
28 
32 
34 
36 


F 


10 


14 
18 
1c 
20 
22 
24 


Figure 5.28 
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1 


4 


1 XX XAXKK 
2 


Variable 


Variable 


Variable 


NOEXTNT 


HKRBA 


HURBA 
HARBA 
PHYBLKSZ 
NOBLKTRK 
NOTRKAU 
ITYPEXT 
ARDPRFMT 
DSDIRSN 


LOKEYV 


HIKEYV 


EXTENT 


Number of extents allocated in this set of 
extents on this volume for this data set. 


RBA of the data control interval with the 
high key. 


High used RBA on this volume 
High allocated RBA on this volume 
Block size 

Number of blocks per track 
Number of tracks per control area 
Flags: 


In an index record: the sequence set is 
with the data. 

The extents are not preformatted 
Reserved 


Data-set directory sequence number in 
the volume control 


Low key on the volume. This field can be 
a maximum of 64 bytes long; the first two 
bytes indicate the length of the field. For 
non-KSDS files, this field contains two 
bytes of zeros. 


High key on the volume. This field can 
be a maximum of 64 bytes long; the first 
two bytes indicate the length of the field. 
For non-KSDS files, this field contains 
two bytes of zeros. 


The field contains a 2-byte length field, 
followed by a 20-byte field for each ex- 
tent. The 20-byte field describes the 
start and end of the extent, in the form 
SSCCHHCCHHTTDDDDDDDD, where SS 
is the data-space sequence number, 
CCHHCCHH is the low and high cylinder 
and head, TT is the number of tracks, 
and DDDDDDDD is the low and high RBA 
of the extent. 





Volume information group occurrence format (part 2 of 2) 
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Password Group Occurrence 


Space Map Group Occurrence 


Licensed Material — Property 





Password information, if any, is contained in the password group occur- 
rence. This group occurrence is associated with a pointer that contains a 
group code of 4. Figure 5.29 shows its format. | 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


Control information 
Byte Meaning 


0 Count of the number of variable 
fields in this group occurrence 


Hexadecimal displacement to 
the first variable-length field 
from the beginning of this 
group occurrence. 


PASSWORD _ Four eight-character passwords, in the 
following order: MASTER, CONTROL- 
INTERVAL, UPDATE, and READ. 


PASSPRMT Password prompting code name that 
allows the operator to provide the cor- 
rect password without displaying the 
data-set name. 


PASSATMP Maximum number of attempts allowed for 
the operator to provide correct pass- 
word. 


8 USVRMDUL Name of the user's security-verification 
p module, if any. 


Variable USERAREC User-authorization record. The first two 
bytes give the length of the user record 
(up to 256) which is contained in the fol- 
lowing bytes. 


Figure 5.29 Password group occurrence format 


The tracks on a VSAM volume are allocated to a VSAM object, or are 
unallocated, as described by the Space Map group occurrence. Each bit 
position describes one track as allocated (bit =0) or unallocated (bit = 1). 
This group occurrence is associated with a pointer that contains a group 
code of 5. Figure 5.30 shows its format. 


All tracks on the volume are mapped, starting at cylinder 0, track 0. Any 
tracks not owned by VSAM are marked ‘allocated’ in order to ensure that 
they are not used by VSAM data sets. 


Field 
Size Field Name Description 


Control information: 
Byte Meaning 
0) Count of the number of variable-length fields in 


this group occurrence (X‘01’) 


Hexadecimal displacement to the variable-length 
field from the beginning of the group occurrence 
(X‘02’). 
2 Length of the field BITMAP. 
Variable BITMAP Portion of the volume bit map (1 to 440 bytes describing 
the allocated /unallocated status of 1 to 3520 tracks). 





Figure 5.30 Space map group occurrence format 
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Data Space Group Occurrence 


Each VSAM data space on the volume is described with a Data Space 
Group ocurrence. This group occurrence is associated with a pointer that 
contains a group code of 6. Figure 5.31 shows its format. 


Bytes and 
Bit Pattern Field Name 


DSCBTS 


DSCBPTR 
SPHDFLG 


NODSPEXT 
DSPSOPT 


DSPSSQ 


SPEXTENT 


Description 


Control information 


Byte Meaning 


fe) Count of the number of variable-length fields in 
this group occurrence (X‘00’). 


Hexadecimal displacement to the first variable- 
length field from the beginning of this group oc- 
currence (X‘55’). 


Format-1 label timestamp, which indicates when the 
label was created. The timestamp is part of the name 
given to the format-1 label. 


CCHHR of the format-1 label 
Data-space flags 


Unique data space, that is, this data space contains all 
or part of only one VSAM object. 

Shared data space, that is, this data space contains all 
or part of two or more VSAM objects. 

Automatically built data space, that is, this data space 
was built as a result of an end-of-volume request. 

This data space contains a VSAM user catalog. 

This data space contains a VSAM master catalog. 
This data space was built when the user issued an 
Access Method Services DEFINE catalog command. 
Reserved 


Number of extents in this data space 
Data-space allocation options 


Track request, which indicates that primary space was 
allocated in terms of tracks. 

Cylinder request, which indicates that primary space 
was allocated in terms of cylinders. 

Reserved 

Class-7 data space. 

Class-6 data space. 

Class-5 data space. 

Class-4 data space. 

Class-3 data space. 

Class-2 data space. 

Class-1 data space. 

Class-0 data space. 


Secondary space allocation quantity by which space is 
to be extended if required. This value is taken either 
from an Access Method Services DEFINE command or 
from the first data set on this volume that caused 
space to be used. This field is used only by OS/VS 
VSAM. 


Sixteen 4-byte extent descriptors in the form TTNN: 


TT - starting track number of the extent (relative to the 
beginning of the volume). 
NN - number of tracks in the extent 





Figure 5.31 Data space group occurrence format 
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Derived Data Space Information 


The following field names identify information that is expected, but not 
contained in the data space group occurrence. The information is derived 
from fields in the volume catalog record. Figure 5.32 shows its format. 


Bytes and 
Bit Pattern Field Name Description 


SPHDFLG Data space flags: 


ea ese A VSAM user catalog is in this data space 
Pree eer A VSAM master catalog is in this data space 
XX.. XXXX Reserved 


2 NODSDSP Number of data sets in the data space - this informa- 
tion is derived by searching each data and index cata- 
log record (pointed to by Data Set Directory Entry 
group occurrences and Cluster catalog records) for a 
volume information group occurrence that contains the 
volume’s serial number. Each group occurrence so 
identified is searched to determine if the data set or 
index has been allocated space in one of the data 
space’s extents. 


The following field names refer to information about an extent of the data space: 


2 TRKSUSED Number of allocated tracks in the extent - the Space 
Map group occurrence is scanned to determine the 
number of allocated tracks, based on the extent’s 
starting track number and total number of tracks 
(contained in SPEXTENT). 


EXTSTART Cylinder and track on which the extent begins - the 
extent’s TT value (contained in SPEXTENT) is convert- 
ed to a CCHH value. 


NOTRKEXT Number of tracks in the extent - the extent’s value 
(contained in SPEXTENT). 


SNSPHD Sequence number of the group occurrence that 
describes the extent’s data space - the sequence num- 
ber of the Data Space Group occurrence. 


Variable SPACEMAP A variable-length space map that defines the allocated 
and unallocated space in the extent - the Space map 
group occurrence is converted to the format of this 
variable-length field based on the extent’s starting 
tracks number and total length (contained in SPEX- 
TENT). 





Figure 5.32 Derived data space information format 


Data Set Directory Entry Group Occurrence 
Each data set that resides in a VSAM data space on the volume is described 
with a Data Set Directory Entry group occurrence. This group occurrence is 
associated with a pointer that contains a group code of 8. Its format is 
shown in Figure 5.33. 


Field 
Size Field Name Description 


Control information 
Byte Meaning 
0 Count of the number of variable fields in this 


group occurrence (X‘00') 


Hexadecimal displacement to the first variable- 
length field from the beginning of this group oc- 
currence. 


DSIDNO Control-interval number of the Data or Index catalog 
record that describes this data set or index. 





Figure 5.33 Data set directory entry group occurrence format 
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Derived Data Set Information 


Field Name Dictionary 


The following field names identify information that is expected, but not 
contained in, the Data Set Directory Entry group occurrence. The informa- 
tion is derived from fields in the volume catalog record. Figure 5.34 shows 
its format. 


Bytes and 
Bit Pattern Field Name Description 


1 DSDIRFLG Flags: 


1 [er The Data or Index catalog record identifies the volume 
as a candidate volume -the Data or Index catalog re- 
cord is searched; its volume information group occur- 
rence VOLFLG field candidate volume indicator (B ‘.1.. 
.... flag) is on. 


Variable DSSPSN A variable-length collection of 3-byte fields that identify 
each data space within which the data set has extents 
allocated to it - this information is obtained by convert- 
ing each volume information group occurrence’s extent 
descriptor’s (EXTENT) SS value (data space extent’s 
sequence number) so that the resulting 3-byte field is: 


Byte Meaning 


O-1 Sequence number of the Data Space Group 
occurrence 


2 Number of extents (groups of contiguous tracks) 
assigned to the data set or index from the data 
space (limits: 1 - 123). 


Figure 5.34 Derived data set information 


The field name dictionary (defined in IGGOCLAY) is an internal data area 
that provides a map between field names and fields within catalog records, 
as well as derived information that is not contained in catalog records. The 
dictionary also allows the dictionary user to specify values (for example, the 
number of group occurrences to be processed) by associating them with a 
dictionary name. Using a field name specified in the CTGFL (field parame- 
ter list), the catalog management modules reference the field name diction- 
ary for the location, length, and type of fields. 


The field name dictionary is a series of 8-byte entries. The first four bytes 
contain a shortened field name consisting of the first, second, fifth, and sixth 
character of the field name in IKQCTGFL. Bytes 4-7 of the field name 
dictionary entry describe the field. When a caller makes a request in a 
CTGEL, dictionary information is moved from the dictionary to the 
CTGFL. 


Figure 5.35 shows the field name dictionary entry format. 
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Offset Bytes and 
Dec Hex Bit Pattern Description 


Shortened field name: the first, second, fifth, and sixth 
characters of the eight-character field name. 


Flags that describe the field. 
Value Meaning 


000 The field is fixed-length and appears in the 
header portion of a record (before the Exten- 
sion record pointer). 

001 A combination field name! 

010 The field is fixed-length and is part of a group 
occurrence that follows the Extension record 
pointer. 

100 The field is variable-length and appears in the 
header portion of a record (before Extension 
record pointer). 

110 The field is variable-length and is part of a 
group occurrence that follows the Extension 
record pointer. 


Special field2 
Special field2 


Not a flag field, which means that a CLC 
(compare logical character) instruction can be 
used to test this field. 

Flag field, which means. that a TM (test under 
mask) instruction can be used to test this field. 
Not a fixed-length field within a variable-length 
field in a group occurrence 

A fixed-length field within a variable-length field 
in a group occurrence 


Reserved 
Bytes that identify the location of the field: 


Type of Contents of 
field name: this byte: 


Fixed-length: Displacement in bytes 
from the 


In the header: beginning of the 
record 

In a group occurrence: beginning of the 
group occurrence 

In a group of Length of the group 

fixed-length fields fixed-length fields 

within a 

variable-length field: 

Variable-length: Zero 


Combination: Index value in the 
combination-name in- 
dex 





Figure 5.35 Field name dictionary entry format (part 1 of 2) 
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Offset Bytes and 
Dec Hex Bit Pattern Description 
Bytes that identify the location of the field (continued): 


Type of Contents of 
field name: this byte: 


Fixed-length: Length of the field (in bytes) 
Variable-length: Sequence number of the field 


Combination: Number of fields identified by the 
combination name 


Value Meaning 


Not a non-repeating volume entry field 
1 A non-repeating volume entry field (i.e., a 
header field) 


.XXX XXXX Group code 
! Combination field name indicates that the name supplied is a name that allows catalog 
management to locate a group of related fields. 


2 The field-name dictionary permits catalog management to locate information that is 
not contained in catalog records. 





Figure 5.35 Field name dictionary entry format (part 2 of 2) 


Combination names are also included in the field name dictionary. Each 
combination name allows catalog management to locate more than one field 
at a time by means of a combination name index. 


The following example shows the relationship of the field name dictionary 
to the combination name index. The three entries in this example are 
shortened field names for NAME, NAMEDS, and TYPE. Since NAME 
and TYPE are only four characters in length, the fifth and sixth characters 
are blanks. The shortened versions, NAbb and TYbb, are combinations of 
the first, second, fifth and sixth characters of the original field names. 
NAMEDS is a combination field name that includes fields NAME and 
TYPE. Thus, byte 5 contains an index value (A) that points to the displace- 
ment in the combination name index (B) which contains, in turn, the dis- 
placement of the first field name (NAME) in the field name dictionary. 
Because byte 6 contains a 2 (meaning that this combination name includes 
two field names), the displacement of the second field name (TYPE) in the 
field name dictionary is given in the byte C following the first displacement 
value in the combination name index. 
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Field name 
dictionary 


Combination 
name index 


where: 
A,B,C 
NAb 
NADS 
TYBi 


Figure 5.36 
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if 


displacement values 
NAMEbB 

NAMEDS 

TYPEBB 


Example of a combination name in field name dictionary 


Section 5. Data Areas 


5.51 


Catalog Dictionary Entries 


5.52 


Figure 5.37 identifies the catalog dictionary entries by field name and 


briefly describes each field. 


AMDSBCAT 


AMDS1 
AMDS2 
ATTR1 
ATTR2 
BITMAP 


BUFSIZE 
CATACB3 
CATSTAT 
CATVOL 


CNTREPNO3 


CRADEVT ACDGIRUVY 
CRAIDNO ACDGIRUVY 
CRAVOL ACDGIRUVY 
DATASPAC V 


DEVTYP 
DEXTENTS 
DIRECTRY 
DSATRO 
DSATTR 


DSCBPTR 
DSCBTS 
DSDIRECT 


DSDIRFLGS 
DSDIRSN 


Description 


Combination name? that includes 
fields AMDS1, HILIRBA, SSRBA, 
AMDS2, TIMESTMP, CATSTAT 


Part of AMDSB 

Part of AMDSB 

Data set attributes 

Data set sharing attributes 


Portion of volume bit map showing 
the allocated and unallocated 
tracks on a direct-access volume 


Minimum buffer size 
Address of catalog ACB 
Part of AMDSB 


Combination name? that includes 
fields RELREPNO, DEVTYP, 
VOLSER, FILESEQ, VOLFLG 


Maximum number of RELREPNOs 
to be processed 


CRA device type 
CRA control interval number 
CRA volume serial number 


Combination name‘ that includes 
fields RELREPNO, SPHDFLG, 
DSCBPTR, DSCBTS, NODSPEXT, 
DSPSOPT, DSPSSQ, SPEXTENT 


Device type 


Combination name‘ that includes 
fields RELREPNO, SPHDFLG, 
NODSPEXT, DSPSOPT, SPEXTENT 


Combination name4 that includes 
fields RELREPNO, DSIDNO 


Combination name4 that includes 
fields ATTR1, ATTR2, OPENIND 


Combination name4 that includes 
fields ATTR1, ATTR2 

CCHHR of F1 label 

F1 label timestamp 

Combination name that includes 
fields RELREPNO, NODSEXT, 
DSIDNO, DSDIRFLG, DSSPSN 
Flags 

Data set directory sequence 
number in the extent descriptor of 
the volume information group 
occurrence 
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DSETCRDT 
DSETEXDT 
DSIDNO 


DSPDSCRP 


DSPSOPT 
DSPSSQ 


DSSPSN5 
DSTYPNAM 
ENTIDNO 


ENTNAME 


ENTVOL 


ENTYPE 
EXCPEXIT 
EXTENT 
EXTSTARTS 


EXTVOL 


FATASPAC 


FCONSPAC 


FEXTENTS 


FILESEQ 
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Record 
Type! 


Group 
Code2 


V 
V 
ACDGIRUVY 
ACDGIRUVY 


ACDGIRUVY 


ACDGIRUVY 
DI 

DI 

Vv 


DI 


Description 


Data set creation date (YDD) 
Data set expiration date (YDD) 


Control interval number of Data or 
Index catalog record that describes 
this data set or index 


Combination name‘ that includes 
fields RELREPNO, TRKSUSED, 
EXTSTART, NOTRKEXT, SNSPHD, 
SPACEMAP 


Options for data space creation 


Secondary data space allocation 
quantity 


Sequence number and number of 
extents 


Combination name?4 that includes 
fields ENTYPE, ENTIDNO 


Control interval number of this 
catalog record 


Data set name (Data, Index, or 
NonVSAM catalog record), cluster 
name (Cluster catalog record), 
volume serial number (Volume 
catalog record) 


Combination name‘ that includes 
fields RELREPNO, DEVTYP, 
VOLSER, FILESEQ, VOLFLG, 
NOEXTNT, HKRBA, HURBA, 
HARBA, PHYBLKSZ, NOBLKTRK, 
NOTRKAU, ITYPEXT, DSDIRSN, 
LOKEYV, HIKEYV, EXTENT 


Catalog record type 
Exception exit 
Extent descriptors 


Cylinder and track on which extent 
begins 

Combination name‘ that includes 
fields RELREPNO, DEVTYP, 
ITYPEXT, EXTENT 


Combination name that includes 
RELREPNO, DSCBTS, DSCBPTR, 
SPHDFLG, NODSPEXT, FSPSOPT, 
FSPSSQ, FPEXTENT 


Fixed block secondary space 
allocation value 


Combination name‘ that includes 
RELREPNO, SPHDFLG, 
NODSPEXT, FSPSOPT, FPEXTENT 


File sequence number for a 
nonVSAM data set that resides on 
tape volume(s) 
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Group 
Code2 Description 


FNTVOL Combination name‘ that includes 
RELREPNO, DEVTYP, VOLSER, 
FILESEQ, VOLFLG, NOEXTNT, 
HKRBA, HURBA, HARBA, 
PHYBLKSZ, NOBLKTRK, 
NOTRKAU, ITYPEXT, DSDIRSN, 
LOKEYV, HIKEYV, FXTENT 


FOLEXT Combination name‘ that includes 
RELREPNO, VOLSER, DSDIRSN, 
FXTENT 


FOLPHY Combination name? that includes 
RELREPNO, VOLSER, VOLFLG, 
NOEXTNT, HKRBA, HURBA, 
HARBA, ITYPEXT, LOKEYV, 
HIKEYV, FXTENT 


FOTRKEXTS Fixed block devices: number of 
blocks represented by space 
descriptor 


CKD devices: number of tracks 
represented by space descriptor. 


FPACEHDRS Combination name? that includes 
RELREPNO, DSCBTS, DSCBPTR, 
SPHDFLG, NODSDSP, NODSPEXT, 
FSPSOPT, FSPSSQ 


FPACOPTN | Fixed block space options for data 
set 


FPACPARM Combination name4 that includes 
FRIMSPAC, FCONSPAC, 
FPACOPTN 


FPEXTENT Fixed block data space extent 
descriptors 


FRENTVOL Combination name 4 that includes 
RELREPNO, DEVTYP, VOLSER, 
FILESEQ, VOLFLG, NOEXTNT, 
HKRBA, HURBA, HARBA, 
PHYBLKSZ, NOBLKTRK, 
NOTRKAU, ITYPEXT, DSDIRSN, 
LOKEYV, HIKEYV, FXTENT 

FRIMSPAC Fixed block primary space 
allocation value 

FRKSUSEDS Fixed block devices: number of 
tracks used in space descriptor 
CKD devices: number of tracks 
allocated per extent 

FSPDSCRPS5. Combination name? that includes 
RELREPNO, FRKSUSED, 
FXTSTART, FOTRKEXT, SNSPHD, 
SPACEMAP 


FSPSOPT Fixed block space options for data 
set creation 
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FSPSSQ 


FXTENT 


FXTSTARTS 


FXTVOL 
GENDSP3 
HARBA 


HARBADS 


HIKEYV 


HILIRBA 
HKRBA 


HKURBA 
HURBA 


HURBADS 


ITYPEXT 
LOKEYV 


LRECL 
MAPSPACE 
NAME 
NAMEDS 
NAME2 


NOBLKTRK 
NODSDSP5 


NODSETS 
NODSExTS 
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Group 
Code2 


DI 

Vv 
CDGIRY 
CDGIRY 


Y 


Description 


Fixed block secondary data space 
allocation value 


Fixed block extent descriptors for 
volume group occurrence 


Fixed block. space descriptor for 
beginning of extent 


Combination name4 that includes 
RELREPNO, DEVTYP, ITYPEXT, 
FXTENT 


Generated data space name 


High-allocated RBA on this volume 
for this data set 


High-allocated RBA of the data set _ 
or index (not always the same as 
HARBA if the data set resides on 
more than one volume) 


Key-sequenced data set’s high key 
value on a volume or, if the data set 
is divided into key ranges, the key 
range's high key value 


AMDSB high-level index RBA 


RBA of the record containing the 
high key of a key-sequenced data 
set on a volume or, if the data set is 
divided into key ranges, the key 
range’s high key value 
Combination name‘ that includes 
fields HKRBA, HURBA 

High-used RBA on this volume for 
this data set 


High-used RBA for the data set or 
index (not always the same as 
HURBA if the data set resides on 
more than one volume) 

Flag 

Key-sequenced data set’s low key 
value on a volume, or if the data set 
is divided into key ranges, the key 
range’s low key value 

Logical record size (data set) or 
X‘FF’ (index) 

Combination name that includes 
fields RELREPNO, BITMAP 
Control interval number of 
associated catalog record 
Combination name that includes 
fields TYPE, NAME 

Control interval number of 
associated catalog record 
Number of blocks per track 


Number of data sets in this data 
space 


Number of data sets on this volume 


Number of data set directory 
extents 
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Field 
Name 


NODSPACES 
NODSPEXT 
NOEXTNT 
NOTRKAU 
NOTRKEXTS 
OPENCNT 


OPENIND 
OPNCALL1 


OWNERID 
PASSATMP 
PASSPRMT 


PASSWALL 


PASSWORD 
PHYBLKSZ 
PRIMSPAC 
RELCRA 


RELIND 
RELREPNO3 
REPNO3 


RGATTR 
SCONSPAC 


SNSPHDS 


SPACEHDRS 


SPACEMAP5 


SPACOPTN 
SPACPARM 


SPEXTENT 
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Record 
Type! 


DI 


DI 


DI 
DI 
DI 


CDGIR 
CDGIR 
CDGIR 


CDGIR 


CDGIR 

D! 

DI 
ACDGIRUVY 


ACDGIRUVY 


GR 
DI 


DI 
DI 


Group 
Code2 


Description 


Number of data spaces on this 
volume 


Number of extents in this data 
space 


Number of extents allocated in this 
set of extents on this volume for this 
data set 


Number of tracks per allocation unit | 
Number of tracks in extent 

Open count 

Open indicator flag 


Combination name‘ that includes 
fields SPACOPTN, BUFSIZE, 
ENTNAME, HURBADS 


Data set owner identification 


Maximum number of attempts 
allowed operator to provide correct 
password 


Password prompting code name for 
security verification 

Combination name4 that includes 
fields PASSWORD, PASSPRMT, 
PASSATMP, USVRMDUL, 
USERAREC 

Four 8-character password 
Physical block size 

Primary space allocation 


Combination name?4 that includes 
fields RELIND, CRAVOL, CRAIDNO, 
CRADEVT 


VSAM release indicator 
Two-byte relative repetition number 


Two-byte highest repetition number 
found 


Path /alternate index attributes 


Secondary space allocation 
requirement 


Sequence number of the group 
occurrence that describes extent’s 
data space 


Combination name‘ that includes 
fields RELREPNO, DSCBTS, 

DSCBPTR, SPHDFLG, NODSDSP, 
NODSPEXT, DSPSOPT, DSPSSQ 


Data space map that defines 


allocated and unallocated space in 
the extent 


Space options flags 


Combination name that includes 
fields PRIMSPAC, SCONSPAC, 
SPACOPTN 


Extent descriptors 
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Description 


SPHDFLGS5 Data space flags 


SRENTVOL Combination name‘ that includes 
RELREPNO, DEVTYP, VOLSER, 
FILESEQ, VOLFLG, NOEXTNT, 
HKRBA, HURBA, HARBA, 
PHYBLKSZ, NOBLKTRK, 
NOTRKAU, ITYPEXT, DSDIRSN, 
LOKEYV, HIKEYV, EXTENT 


SSRBA DI AMDSB sequence-set RBA 

SYSEXTDS V Number of system-allowed extents 
per suballocation request 

TIMESTMP DI AMDSB time stamp 

TRBAEXT3 DI This is a test RBA for EOV mount by 
RBA 


TRKSUSEDS V Number of allocated tracks per 
extent 


TYPE CDGIRY Associated catalog record type 
TYPE2 Y Associated catalog record type 


UPDVOL DI Combination name‘ that includes 
fields RELREPNO, DEVTYP, 
VOLSER, FILESEQ, VOLFLG, 
NOEXTNT, HKRBA, HURBA, 
HARBA, PHYBLKSZ, NOBLKTRK, 
NOTRKAU, ITYPEXT, DSDIRSN, 
LOKEYV, HIKEYV 


Combination name‘ that includes 
fields TYPE, NAME, TYPE2, 
NAME2 


USERAREC User authorization record 


USERINFO User information for ISAM Interface 
Program 

USVRMDUL User security verification module 
name 

VOLDEV Combination name‘ that includes 
fields DEVTYP, PHYBLKSZ, 
NOBLKTRK, NOTRKAU 

VOLDVCHR Device characteristics 

VOLEXT Combination name?‘ that includes 
fields RELREPNO, VOLSER, 
DSDIRSN, EXTENT 

VOLFLG Volume flags 

VOLPHY Combination name‘ that includes 
fields RELREPNO, VOLSER, 
VOLFLG, NOEXTNT, HKRBA, 
HURBA, HARBA, ITYPEXT, 
LOKEYV, HIKEYV, EXTENT 

VOLRFLG Volume record flags 

VOLSER Volume serial number 


VOLTSTMP : Volume time stamp 
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Dictionary Example ! 


1 Record type indicates which catalog record contains the field name: 


A -non-VSAM 

C - Cluster 

D - Data 

G - Alternate index 
| - Index 

R - Path 

U - User catalog 

V - Volume 

Y - Upgrade set 


2 Group code indicates which group occurrence contains the field: 


- Field is in the header portion of the record, not associated with any group 
occurrence 

AMDSB group occurrence 

Association group occurrence 

Volume information group occurrence 

Password group occurrence 

Space map group occurrence (contained only in a Volume catalog record) 
Data space group occurrence (contained only in a Volume catalog record) 
Space descriptor group occurrence (derived) 

Data set directory entry group occurrence (contained only in a Volume catalog 
record) 


3 Special names not contained in the catalog; their values are derived from other 
sources, in most cases to locate repetitive data and control processing. 

4 Combination names allow catalog management to locate more than one field at a time 

5 These field names identify information that is expected, but not contained in, the data 


space or data set directory group occurrences. The information is derived from fields 
in the Volume catalog record. , 


1 
2 
3 
4 
5 
6 
7 
8 
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To clarify the use of the dictionary as a means of gaining access to catalog 
information, refer to the examples that follow. 


The DSETCRDT (data set creation date) field appears in the dictionary, as 
follows: 


C4E2C3D900650300 


The first 00 is the fifth-byte value of the record; it indicates that 
DSETCRDT is (a) a fixed-length field, (b) not part of a group occurrence, 
and (c) not a flag field. 


The 65 is the sixth-byte value of the record; it indicates that DSETCRDT is 
at displacement X‘65’ from the beginning of the record in which it appears. 
The 03 is the seventh-byte value of the record; it indicates that DSETCRDT 
is three bytes long. 

The 00 is the eighth-byte value of the record; it is zero because DSETCRDT 
is not part of a group occurrence and, therefore, is not associated with a 
group occurrence code. 

Although the dictionary entries are 8 bytes long, only the first, second, fifth, 


and sixth characters of the field name appear. For DSETCRDT, only 
DSCR (C4E2C3D9) appears. 
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Dictionary Example 2 
The DSPSOPT (data-space-creation space options) field appears in the 
dictionary, as follows: 

C4E2D6D750130106 

The 50 is the fifth-byte value of the record; it indicates, when converted to 
binary, that DSPSOPT is (a) a fixed-length field that is part of a group 
occurrence, (b) a flag field, and (c) not a repeating field within a variable- 
length field. 
The 13 is the sixth-byte value of the record; it indicates that DSPSOPT is at 
displacement X‘13’ from the beginning of the record in which it appears. 
The 01 is the seventh-byte value of the record; it indicates that DSPSOPT is 
one byte long. 
The 06 is the eighth-byte value of the record; it indicates that DSPSOPT is 


part of a group occurrence associated with a code of 6, which means that it is 
part of a group occurrence that contains VSAM data-space information. 


Licensed Material — Property of IBM Section 5. Data Areas 5.59 


09'S 


] swNjOA ‘1307 WYSA WVSA/ASA 


Wal JO Ayedosg — jelue}eW pesued!q 


St's o1n8]y 


398 BBP paouanbas-Aay B 10} 91N}9NIYS YIO[G [019U09 LWSA 


User’s record management request: | VSAM user: 


GET, PUT, POINT, ERASE, or ENDREQ 
| R1 

















































| 
ISAM user: ‘. 
R1 AMDTF | 
| 
Describes the VSAM 
RPLAD record processing 
request 
DTFIS ACBAD + ACB 
AMDTFAD | ACB 
CIPROCAD | 
IIPPRCPR l Describes the VSAM 
data set 
| tT AMBL 
Address table | 
Note: Present only if using IIP. | t Record 
management 
1 load module 
a Tt EXLST 
VSE | 
| 
Loc. X‘16' COMREG ANCHT 
| 


AMBL 
t Data AMDSB 









t Index AMDSB 
t PLHs 





t Exclusive control 
list 





IKQOVSM 


EXLST 


User exit routines 
t LERAD 
tSYNAD 
+t EODAD 
Tt EXCPAD 
t JRNAD 


See Figure 5.39 
Data and index 
control block 
structure 


AMBL 






Describes an 
opened cluster 





t Data AMDSB 
t Index AMDSB 
t PLHs 


t ACB 


t Exclusive 
control list 


t PLHs of 
base cluster 1 


t usB1 






Index AMDSB 





Same control 
block structure 
as data AMDSB 










1 The base cluster AMBL 
points to the USB. The 
AIX AMBLs point to the 
PLHs of the base cluster. 


Figure 5,39 















Data AMDSB EDB 










Describes a disk 
extent (1EDB for 
each extent) 


t Next EDB 
t LPMB 
t ARDB 


LPMB 
Describes physical 
disk attributes 


Data ARDBs 


Space allocation 
information (RBA) 
for each key range 


tEDB 
tT Index ARDB 


Statistical 
information 


tEDB 
tARDB 
t BCB 









t CCW build area 


PLHs 


Information about 
current request 






TRPLs 


ECB 





t Current ARDB 









t BHD 
t Current BCB 






t Current buffer 


t THB 


Data BHD 


Information 
about buffers 


BCBs 


Status information 
about a buffer (1 for 
each buffer) 


t Buffer 


t Next BCB in queue 






t Buffer queues 


Data free queue 


fe) 
= 
Q 
a 
+ 
cy 
= 
©) 
a 
c 
] 
Cc 
i) 
77) 


BCB 


BCB 


Data and index control block structure 
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EDBs 


Buffers 
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R11 
t CCA 


CCA 


t Label area 
information 


tDADSM 
parameter list 


t CPL 


+ ACB (current) 


t Active RAB 





RAB (6) 





t Catalog 
record in 
a buffer 


t's to fields 
in the buffer 


tT RPL (current) 
t Active FPL 


t Next available 
space in work 
area 





+t CMS work area 


t CRA definition 
work area 


+t CRA buffer chain 


DADSM parameter list * 
Volume identifier 


t Label area 
information 


t 1/0 area 


VTOC information 


256-byte label record 


es ACB (Master catalog) 






Describes the catalog 
asa VSAM key - 
sequenced data set 








RPis (Master catalog) 





Describes the VSAM 
record processing 
request 






Ieee x‘16' COMREG ANCHT 


* See IKOMDADS, DADSM parameter list, 
defined in module |GGOCLC9 for details. 


AMCBS 


Interface between 
ANCHT and the 


VSAM catalog 
control blocks 





CAXWA chain 


t's control blocks 
and work areas 
needed for catalog 






processing 





(a) See Diagram 5.41 





Control blocks for further catalogs 
and CRAs (if present) 


i 





ACB (Job catalog) 


RPLs (Job catalog) 


ae = 


ACB (e.g. User catalog) 


RPLs (e. g. User catalog) 


ACB (e.g. CRA) 


RPLs (e.g. CRA) 





PA 


yar i a ay ee eae ee a ee ee 


jeleyeW pesuedi 


Wal $0 Ayedoig 


seoly b1Bq ‘¢ UOTIDIS 


€9's 


Ip’s aan8yq 
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tT CPL 


i 
—_ 


From 
Diagram 5.40 


oO 


PL 


© t Catalog identifier 


t Catalog record 
identifier 


t Work area 
t Password 
tFEVT 


Information for 
locating the CRA 


T FPL 
T FPL 


Work area 
Field’s data . 
From 
Diagram 5.40 Field's data 


ce) Available space 


FPL 


+ Field name 


+ FPL for tests 





t Field’s data 


FPL for tests 


t Field name 


Test condition 


tT FPL=0: 
No more tests, 
or 


Tt FPL for next test 


Test data area 















t's to user-supplied 
information fields 
and lists 


FPL 


t Field name 


T FPL=0: 
No tests 


t Work area: 

Update data or 
field's (retrieved) 
data and length 








FVT (data) 

oe 

1 

1 4 

FVT (index) 

\ t 

» L 

! 

t 

! 

j 

FVT (space) 


~ 
| 
i 
Y 


if DEFINE 
Cluster, 
Catalog, or 
AIX 


lf DEFINE 
Cluster, 
Catalog, AIX, 
or Space 


Control Block Description and Format 


Access Method Control Block (ACB) 


The VSAM ACB describes a VSAM cluster. It is built by the user’s pro- 
gram. The ACB points to the Exit List (EXLST). After the cluster is 
opened, the ACB is pointed to by the RPL (RPLDACB) that describes the 
user’s record processing request. The ACB also describes the processing 
options, password, and I/O buffer space applicable to the user’s program. 


Offset 
Dec Hex 


Bytes 


Field Name 


ACBST 
ACBID 
ACBIDD 
ACBIDVAL 


ACBSTYP 
ACBSDV1 
ACBSVSE1 


ACBLEN 
ACBLENG 
ACBAMBL 
ACBAMO 
ACBACT 


ACBINFLG 
ACBSCRA 


ACBUCRA 


ACBSTSKP 


ACBDBUF 
ACBBUFND 
ACBIBUF 
ACBBUFNI 
ACBMACRF 


ACBMACR1 
ACBKEY 


ACBADD 
ACBADR 
ACBCNV 
ACBSEQ 
ACBDIR 
ACBIN 
ACBOUT 
ACBUBF 


Hex. 
Digit 


X‘80' 


- X'40' 


X'40' 
X'20' 
X'10' 
X‘08' 
X'04’ 
X'02’ 
X'01' 


Description 


ACB identifier = ‘AQ’ 
ACB equate 
ACB equate 


Release indicator 
DOS/VS VSAM Release 1 
VSE/VSAM Release 1 
VTAM 


Length of ACB in bytes 
Length of ACB in bytes! 
Address of the AMBL 
Pointer to VSAM code 


ACB active byte (X‘FF’ =ACB is 
active). 


Catalog recovery flags 
ACB is for a system-initiated 
OPEN of the CRA 

ACB is for a user-initiated 
OPEN of the CRA 
Reserved for CRA 
Reserved for CRA 

Skip updating of statistics 
Reserved for CMS 
Reserved for CMS 
Reserved for CMS 


Number of data buffers 
Number of data buffers 
Number of index buffers 
Number of index buffers 
MACRF 


MACRF first byte 
Access data via index or 
relative record number 
Access via RBA 

Access via RBA 

Control interval processing 
Sequential processing 
Direct processing 

GET 

PUT 

User buffers 


1 If specified length is too small for a VSE/VSAM Release 2 ACB, a Release 1 ACB is 


built (X'00' in byte 1). 


Figure 5.42 
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Offset 
Dec Hex 


Figure 5.42 
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Field Name 


ACBMACR2 


ACBLSR 
ACBDFR 
ACBSKP 
ACBRST 
ACBAIX 
ACBJRACT 


ACBDOSID 
ACBDTFID 
ACBOFLGS 


ACBVOLMT 
ACBVMSG 
ACBEOV 
ACBOPEN 
ACBCAT 
ACBEXFG 
ACBSUB 


ACBKEYOK 


ACBNST 
ACBSTRNO 
ACBERFLG 


ACBOINCB 
ACBOALR 
ACBOLLUB 


ACBONJIB 


ACBOLIGN 


ACBOLUNA 


_ACBOAASF 


ACBOIDSP 


ACBOCEXT 


ACBONOAL 


ACBONANR 


Hex. 
Digit 


Description 


MACRF second byte 


Local shared resources 
Defer writing of buffers 
Skip sequential access 
Reusable data set 

AIX processing only 
JRNAD exit active 

DOS DTF identifier 

DTF type for VSAM 
Open/close flags 

Verify volume mounted 
Message requested bit 
EOV detects completed 
ACB is open 

ACB for VSAM catalog 
User exit flag 

ACB is suballocated (is located 
in a control block allocation 
unit) 

Key processing all right for this 
ACB 

Number of strings 

Number of strings 


Error flags 


Open error return codes: 


X'02' 
X'04' 
X'OE’ 


Invalid control block structure 
This ACB is already open. 


The symbolic unit in the DLBL 
statement is invalid. 


No job information blocks 
(JIBs) are available from the la- 
bel information cylinder. 


The address in the ASSGN 
statement for the logical unit 
was IGN (assignment ignored). 
The address in the ASSGN 
statement for the logical unit 
was UA (logical unit unas- 
signed). 

Unable to automatically assign 
a logical unit number 


The OPEN disposition specified 
for the file conflicts with other 
file characteristics. | 


The volume serial numbers 
specified in the EXTENT state- 
ment do not match those speci- 
fied in the catalog entry. 

No space available on any 
volume for primary allocation of 
a dynamic file 

An attempt was made to opena 
NOALLOCATION file which is 
not reusable. 
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Offset 
Dec Hex 


Figure 5.42 
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Fleld Name 
ACBOCDLD 


ACBONCIF 


ACBOSENS 


ACBOIRCZ 


ACBOUEXP 


ACBODMOD 


ACBONSDS 


ACBOBNAM 


ACBORCSZ 


ACBONALC 


ACBOIDEL 


ACBOIDEF 


ACBONMNT 


ACBONCRA 


ACBOIERR 


ACBOUEMP 
ACBOTMST 


Hex. 
Digit 


X‘32’ 


X'40’ 


X'41' 


Description 


Unable to load VSAM modules 
via a CDLOAD macro instruc- 
tion. 


An attempt was made to open a 
NOCIFORMAT file using VSAM 
(ACB) access. 


An attempt was made to open a 
SAM ESDS without the 
VSE/VSAM space Manage- 
ment for SAM Feature installed. 


An attempt was made to open a 
DTF whose file characteristics 
do not match the file character- 
istics of the VSAM catalog. 


An attempt was made to open 
an unexpired file for output us- 
ing a DTF. 


The file to be opened has a 
name which begins with an in- 
valid prefix. 


An attempt was made to opena 
nonSAM ESDS file using a 
DTF. 


An invalid file-id was detected 
during implicit define or implicit 
delete. 

Allocation specifications for 
implicit define conflict with the 
file characteristics specified in 
the DTF and conversion to cor- 
rect the conflict was unsuc- 
cessful. 


The file-id specified in your 
DLBL statement was not found 
in the catalog and insufficient 
allocation information is speci- 
fied for an implicit define. 


A catalog management error 
was detected during implicit 
delete. 


A catalog management error 
was detected during implicit 
define. 


Attempt to mount two volumes 
on the same drive when direct 
or keyed processing was speci- 
fied. Or the operator failed to 
mount the volume. 


CRA volume not mounted 
Unusable input data set 
Empty upgrade AIX 


The time stamp of the volume 
on which a data set is stored 
doesn't match the system time 
stamp in the volume catalog 
entry. 





Access Method Control Block (ACB) description and format (part 3 of 6) 
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Offset Hex. 
Dec Hex Bytes Field Name Digit Description 


ACBOTIME X'6C’ The system time stamps of a 
data set and its index do not 
match. This indicates that the 
data has been updated sepa- 
rately. This test is greater than 
or equal, i.e., no warning is giv- 
en if the index time stamp is 
greater than the data time 
stamp. 


ACBOEMPT X'6E’ Open empty data set for read 
only. 

ACBODSNC X'74' Data set was not closed the 
last time it was processed. 


ACBODEVT X'75' The symbolic unit specified in 
the EXTENT statements is not aj 
valid VSAM device type, or in- 
valid extents are specified. 


ACBONDLB X‘80’ The DLBL statement is missing 
or the filename in the DLBL 
doesn't match the ACB. 


ACBOIOER X'84' A permanent I/O error occur- 
red while VSAM was reading 
label information from the label 
information cylinder. 


ACBONVRT X'88' Not enough virtual storage 
space is available in the parti- 
tion for work areas, control 
blocks, or buffers. 


ACBOIOCA X'90’ A permanent I/O error occur- 
red while VSAM was reading or 
writing a catalog entry. 


ACBONCAT X‘94' No entry was found in the 
catalog for this ACB. 


ACBOSECU X‘98' Security verification failed: the 
password specified in the ACB 
for a specific level of access 
doesn't match the password in 
the catalog for that level of ac- 
cess. 


ACBOPARC X‘AO’ The operands specified in the 
ACB are inconsistent with each 
other or with the information in 
the catalcg entry, for example, 
an open of an ESDS for keyed 
processing. 

ACBOKBUF X‘Al' User-specified buffers with 
keyed access (user buffers can 
be specified only with CNV ac- 
cess). 

ACBOLIOE X‘AS’ A permanent I/O error was 
detected on the system lock 
file 

ACBOLTEX X'A6' The system lock table is not 
large enough to accommodate 
the concurrent requests. 

ACBOLFEX X'A7' The system lock file is not large 
enough to accommodate the 
concurrent requests. 


eo 





Figure 5.42 Access Method Control Block (ACB) description and format (part 4 of 6) 
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5.68 


Offset 
Dec Hex 


Figure 5.42 
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Field Name 
ACBONAVA 


ACBONOCT 


ACBOACT 

ACBOOERR 
ACBOPEMP 
ACBOLEMP 


ACBOLKEY 


ACBOLBUF 


ACBOLNRP 


ACBONRST 
ACBOILAB 
ACBOLUNX 


ACBOCTER 


ACBOINCB 


ACBCALR 
ACBCDSFL 
ACBCNVRT 


ACBCIOCA 


ACBCNCAT 
ACBCIOER 


ACBCBUSY 


Hex. 
Digit 


X‘AB’ 


X'E8' 
X'F8' 
X'FE' 


X'FF 


Description 


The data set is not available 
because it is being updated by 
(under the exclusive control of) 
another ACB or has been ex- 
ported by Access Method Ser- 
vices. 


The VSAM catalog is not 
connected to the system on 
logical unit SYSCAT, or insuffi- 
cient virtual storage available 
for OPEN. 


ACB was active. 
Unusable output data set 
Access via empty path 


LSR is specified but the data 
set being opened is empty 
(which implies that it is to be 
loaded). 


LSR is specified but the key 
length of the data set being 
opened is greater than the 
maximum key length specified 
for the resource. 


LSR is specified but the Cl size 
of the data set being opened is 
greater than the largest buffer 
size specified for the resource 
pool. 

LSR is specified but there is no 
resource pool defined; may 
also be caused by problems 
while loading the resource ta- 
ble. 

Non-reusable file is not empty. 
IKQLAB internal error 

OPEN detected an unexpected 
return code from the Lock 
Manager 

Unexpected return from 
catalog locate function. 


Close error return codes 


X‘02' 
X'04' 
X'4C' 
X'88' 
X‘90’ 


X'94' 
X‘B8' 


X'BC' 


invalid control block, or ACB 
address not in OAL 

ACB already closed 

CLOSE disposition failed 
Insufficient space available in 
user's partition for work area. 


Permanent !/O error occurred 
while VSAM was reading or 
writing a catalog entry. 

No catalog entry found 
Permanent I/O error occurred 
while VSAM was completing 
outstanding |/O requests. 


ACB busy. 
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Field Name 
ACBCDTFA 


ACBAMBUF 
ACBDDNM 
ACBPRTCT 
ACBUAPTR 


ACBBFPL 


ACBEXLST 
ACBBPLS 


ACBOFLG2 


ACBKEEP 
ACBDELET 
ACBDATE 


ACBMSGLN 
ACBMSGAR 
ACBNMPTR 


ACBEND 


Hex. 
Digit 


X‘FC’ 


X‘'80' 
X'40' 
X'20' 
X'10’ 
X‘08' 
X'04' 
X‘02’ 


X'01' 


Description 


Automatic close of the DTF for 
a managed-SAM file failed 


Length of buffer pool 
DDname 
Pointer to password 


Pointer to user work area, or to 
CAXWA if ACB is for a catalog. 


Pointer to first data buffer in 
buffer pool 


User exit list pointer 
BAM parameter list pointer 
Reserved 


Second OPEN/CLOSE flag 
byte 

Reserved 

Reserved 

Reserved 

Reserved 

Close disposition is KEEP 
Close disposition is DELETE 
Close disposition is controlled 
by the expiration date 
Reserved 

Message area length 
Message area 

Pointer to 44 character name 


End of ACB 





Access Method Control Block (ACB) description and format (part 6 of 6) 


Section 5. Data Areas 5.69 


Access Method Block List (AMBL) 
The AMBL describes a VSAM cluster and points to the cluster’s data set 
and index AMDSBs. When the cluster is opened, an AMBL is built to 
describe the cluster. AMDSBs are built to describe the cluster’s data set and, 
if the cluster is key-sequenced, to describe the index. The AMBL is pointed 
to by the cluster’s ACB (ACBAMBL). 


Offset Hex. 
Dec Hex Bytes Field Name Digit Description 


AMBLST Beginning of AMBL 
AMBLID AMBL identifier 
AMBLACT AMBL active byte 
(X'FF’=AMBL is active) 
AMBLLEN Length of control block 
AMBLDTA Pointer to data AMDSB 
AMBLIX Pointer to index AMDSB 
AMBLPLHF Pointer to first PLH* 
AMBCHAIN Reserved 
AMBLACB Pointer to ACB 
AMBLPLHL Length of PLH* 
AMBLPLHN Total number of strings * 
AMBLFLAG Flag byte 
AMBLPOST ‘80’ POST must be issued 
AMBAMBUF Size of buffer space 


AMBMACRF Flags (copy of flags in 
ACBMACR1 and ACBMACR2) 


AMBMACR1 First byte: 


AMBKEY X‘80’ Access data via index or 
relative record number 

AMBADD X‘40' Access via RBA 

AMBADR X'40’ Access via RBA 

AMBCNV X‘20' Control interval processing 

AMBSEQ X'10’ Sequential processing 

AMBDIR X'08' Direct processing 

AMBIN X'04' GET, READ processing 

AMBOUT X'02’ PUT, WRITE processing 

AMBUBF X‘01' User buffers 


When LSR is active, AMBLRPHD*0, and AMBLSR in AMBMACR2 is set on. In 
this case, the fields indicated by the asterisk refer to the PLH pool. 


—_ A 


2 
4 
4 
4 
4 
4 
2 
1 
1 





Figure 5.43 Access Method Block List (AMBL) description and format (part 1 of 3) 
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Offset 


Dec Hex 
33 21 
34 22 
36 24 
38 §=26 
40 28 
44 2C 
45 2D 
46 2E 
47 2F 
48 30 
48 30 
50 = 32 
51 33 
52 34 
52 34 
56 38 
60 3C 

Figure 5.43 
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Bytes 
1: 


Fleld Name 


AMBMACR2 


AMBLSR 
AMBDFR 
AMBSKP 
AMBRST 
AMBAIX 
AMBJRACT 
AMBOPEN 


AMBLTLEN 


AMBDBUF 
AMBIBUF 
AMBLOPWA 


AMBSECB 
AMBSRCL 


AMBSCOM 
AMBSWAIT 


AMBSECBT 
AMBBECB 


AMBBCOM 
AMBBWAIT 


AMBBECBT 
AMBRBAS 
AMBLORBA 


AMBHIRBA 


AMBSTRID 


Hex. 
Digit Description 

Second byte: 

X'80' Local shared resources 

X'40' Defer writing of buffers 

x‘20' Skip sequential accessing 

X‘10' Reusable Data Set 

X'08' AIX processing 

X'02' JRNAD exit enabled 

X'01' Open is in process 
Length of GETVIS for close 
work area 
Number of data buffers 
Number of index buffers 
Pointer to open work area 

Split Control 
Split/pseudo-split ECB 

X‘80’ IKQRCLO0 set split lock 

X‘40’ Reserved 

X‘20’ Reserved 

x‘10’ Reserved 

X‘08’ Reserved 

X‘04’ Reserved 

X‘02’ Reserved 

X‘OrV’ Reserved 
Reserved 
ECB post byte-split 

X‘80’ Wait bit-split 

X‘40’ Reserved 

X‘20’ Reserved 

X‘10’ Reserved 

X‘08’ Reserved 

X‘04’ Reserved 

X‘02’ Reserved 

x‘Ol’ Reserved 
Test-and-set byte - split 
ECB for IKQRQC to ensure that 
only one string (at a time) ex- 
tends the chain of base cluster 
RPLs during path processing in 
an LSR environment. 
Reserved 
ECB Post byte - buffer 

X‘80’ Wait bit-buffer manager 

X‘40’ Reserved 

X‘20’ Reserved 

X‘Or’ Reserved 

X‘08’ Reserved 

x‘04 Reserved 

X‘02’ Reserved 

X‘Or’ Reserved 
Test-and-set byte - buffer 
RBAs for split locking 


Low RBA of control area being 
split 
High RBA of control area being 
split 
ID of string which holds control 
area. 


Access Method Block List (AMBL) description and format (part 2 of 3) 


Section 5. Data Areas 5.71 


Offset Hex. 


5.72 


Dec Hex Bytes FieldName Digit Description 
61 3D 1 AMBOCSW OPEN/CLOSE switches 
AMBLAUTO X'80' A dynamic volume list was built 
for this ACB 
X'40' Reserved 
X‘20' Reserved 
X‘10’ Reserved 
X'08' Reserved 
X'04' Reserved 
X‘02’ Reserved 
X‘O1' Reserved 
62 3E 2 Reserved. 
64 40 4 AMBPLH Address of PLH in control 
Pointers 
68 44 4 AMBALIST Executive control list address 
72 48 4 AMBLRPLS Address of RPL causing split 
76 =4C 4 AMBLCLWA Pointer to close work area 
80 50 4 AMBLCIWA Pointer to Ci split work area © 
84 54 4 AMBLBC Pointer to base cluster PLH 
pool 
88 58 4 AMBLUSB Pointer to USB 
92 5C 4 AMBBCACB Pointer to base cluster ACB 
96 #660 4 AMBPEACB Pointer to path entry ACB 
100 64 4 AMBLRPHD Pointer to resource pool 
header 
104 68 4 AMBDECB ECB for duplicate data re- 
covery 
104 68 2 Reserved 
106 6A 1 AMBDCOM ECB post byte - duplicate data 
recovery 
AMBDWAIT X‘80' Traffic bit 
X‘40' Reserved 
X‘20’ Reserved 
X‘10' Reserved 
X‘08' Reserved 
X‘04' Reserved 
X'02' Reserved 
X‘01' Reserved 
107 6B 1 AMBDECBT Test-and-set byte - duplicate 
data recovery 
108 6C 0 AMBLSHRW Pointer to file sharing work 
area 
Figure 5.43 Access Method Block List (AMBL) description and format (part 3 of 3) 


VSE/VSAM VSAM Logic, Volume ! 


Licensed Material — Property of IBM 


Access Method Control Block Structure (AMCBS) 


The AMCBS is pointed to by the Anchor Table (ANCHT) and, in turn, 
points to the VSAM catalog’s ACB and CAXWA. 





Offset Hex. 
Dec Hex Bytes Field Name Digit Description 

CBSID AMCBS identifier 

CBSFLAGS AMCBS flags 

CBSJCAT ‘80’ Job catalog not present 

CBSSIZ Length of the AMCBS 

CBSCRACB Pointer to CRA ACB 

CBSACB Pointer to ACB (Master) 

CBSCRAPL Pointer to AMS CRA parameter 
list. 

CBSSYSUC Pointer to job catalog ACB 

CBSCAXCN Pointer to CAXWA chain 

CBSCBMM Pointer to Control Block 
Manipulation Macro load mo- 
dule 

Figure 5.44 Access Method Control Block Structure (AMCBS) description and 
format 


Access Method Data Statistics Block (AMDSB) 


The AMDSB contains statistical information about record processing in the 
data set. It also contains some of the data set’s attributes and specifications. 
The AMDSB is built, using the data index or index catalog record’s 
AMDSSB group occurrence, when the cluster is opened. The AMBL 
(AMBLDTA/AMBLIX) points to the data and index AMDSBs. 


Licensed Material — Property of IBM Section 5. Data Areas 5.73 


5.74 


Offset Hex. 


Dec Hex Bytes Field Name Digit Description 


General 


11 


12 


14 


AMDCOMM 
AMDSBID 
AMDATTR 
AMDATTR1 
AMDDST 
AMDOWCK 
AMDSDT 


AMDREPL 
AMDORDER 


AMDRANGE 


AMDRRDS 
AMDSPAN 


AMDLEN 


AMDNEST 


AMDAXRKP 


AMDRKP 
AMDKEYLN 
AMDPCTCA 


AMDORCFRM 
AMDIMPDF 
AMDNCIFT 


AMDNCAFT 


AMDSBLKD 
AMDSVAR 


AMDSFIXD 
AMDPCTCI 
AMDCIPCA 


AMDFSCA 


X‘60’ 


X'04' 
X'02’ 


X'01' 


Common part 
AMDSB identifier 
Attributes of the data set 


Attributes (first byte): 
Key-sequenced data set 
Check each record when it is 
written 

Sequence set is stored with the 
data 

Replication 

Use the volumes in the same 
order as in the volume list 

The data set is divided into key 
ranges 

Relative record data set 
Spanned records 


Length of AMDSB in the 
catalog 


Number of entries in an index 
section (in all cases except 
AMDSB group occurrence in 
data record of AIX)! 


Relative key position in base 
record (only for AMDSB group 
occurrence in data record of a 
AIX)! 


Relative key position 
Key length 


Percentage of free control 
intervals in the control area 


SAM ESDS record format 
information 

File definition was by implicit 
define 

Non-control-interval format 
(processable by SAM only) 
Non-control-area format (This 
bit indicates the file is a SMA 
ESDS. If both this bit and 
AMDNGCIFT are off, and file is a 
VSAM ESDS.) 

The SAM record format is 
blocked 

The SAM record format is 
variable length records 

The SAM record format is fixed 
length records 


Percentage of free bytes in the 
control interval 


Number of control intervals ina 
control area 


Number of free control intervals 
in a control area 


IFor more details of these fields, see the explanation of the AMDSB group occur- 





rence. 


Figure 5.45 Access Method Data Statistics Block (AMDSB) description and format 
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Offset 
Dec Hex 


Field Name 


AMDFSCI 


AMDCINV 
AMDLRECL 


AMDHLRBA 


AMDNSLOT 
AMDBLREC 


AMDSSRBA 


AMDMAXRR 
AMDPARDB 
AMDATTR3 
AMDUNQ 


AMDSTAT 
AMDSTMST 
AMDSTSP 
AMDSTAT1 
AMDNIL 
AMDNEDB 
AMDNEXT 


AMDNLR 


AMDDELR 
AMDIREC 
AMDUPR 
AMDRETR 
AMDASPA 


AMDNCIS 


AMDNCAS 


AMDEXCP 


Description 


Number of free bytes in a 
control interval 


Control interval size 


Maximum record size. For a 
SAM ESDS, this is the maxi- 
mum SAM logical blocksize 


RBA of the high-level index 
record 


Number of relative record slots 


SAM LRECL, for fixed-blocked 
SAM ESDS 


RBA of first sequence set 
record 


Max. relative record number 
Pointer to first ARDB 
Attributes 

Non-unique keys in AIX 
Unique keys in AIX 


Reserved 
Reserved 


Statistics 


Statistics 
System time stamp 
System time stamp 


Number of index levels 
Number of EDBs 


Number of extents in the data 
set 


Number of user-supplied 
(logical) records in the data set 


Number of deleted records 

Number of inserted records 
Number of updated records 
Number of retrieved records 


Number of bytes of free space 
in the data set 


Number of times a control 
interval was split 

Number of times a control area 
was split 

Number of times EXCP was 
issued by VSAM I/O routines 





Figure 5.45 Access Method Data Statistics Block (AMDSB) description and format 
(part 2 of 4) 
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Offset 
Dec Hex 


96 


97 
101 


104 


108 


109 
110 
112 
116 


117 


120 
120 
122 


124 


128 


132 


136 


60 


61 
65 


6C 


6D 
6E 
70 
74 


75 


76 


78 
78 
7A 


7C 


80 


84 


88 


Bytes 


Field Name 


AMDSHOPT 
AMDSHR1 
AMDSHR2 
AMDSHR3 
AMDSHR4 


AMDCDSN 
AMDDSN 


AMDHWRBA 


AMDATTR2 
AMDREL 
AMDLOAD 
AMDSPEED 
AMDINDX 
AMDSHR 
AMDKR 


AMDMXARC 


AMDCAT 
AMDACT 
AMDFILT 
AMDPVOL 


AMDAMS 
AMDAIX 
AMDPATH 
AMDBASE 


AMDATTR4 
AMDARCH 


AMDARCHS 


AMDAIRKP 


AMDLSTAT 
AMDLNIL 
AMDLNEST 


AMDLNLR 


AMDLDELR 


AMDLIREC 


AMDLUPR 


Hex. 
Digit 


Description 


General Continue 


X'80' 
X‘40' 
X'20' 
X'10' 


X‘80' 
X'40' 
X'20' 
X'10' 
X'08' 
X'04' 


X'02' 
X'01" 
X‘80' 


X'40' 
X'20' 


X'80' 


X'40' 


Share option byte 
Share option 1 
Share option 2 
Share option 3 
Share option 4 


Pointer to catalog ACB 


Catalog control interval number 
for data (index) 


High-water RBA for the data 
set 


Attributes (second byte): 
Release unused space 

Load mode 

Speed option 

Index option 

Sharing 

Key-range processing, dupli- 
cate of AMDRANGE 

This component contains both 
fixed block and CKD files (set 
only when a mixed architecture 
index opens itself). 

AMDSEB for catalog 


AMDSB test and set byte 
User area (ISAM compatibility) 
Pointer to volume fist 


AMS flag byte 
Alternate index 
Access via path 
Access via base 


Attributes (fourth byte): 
Data component: component 
resides on a fixed block device. 


Index component: high level 
index is on a fixed block de- 
vice. 

Sequence set resides on a 
fixed block device (index com- 
ponents only). 

Relative key position in base 
record (only in data AMDSB of 
AIX)! 


Local Statistics 


Local statistics 
Local number of index levels 


Local number of entries in the 
index section 

Local number of user-supplied 
(logical) records 

Local number of deleted 
records 

Local number of inserted 
records 


Local number of updated 
records 


IFor more details of these fields, see the explanation of the AMDSB group occur- 


rence. 


Figure 5.45 
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Offset 
Dec Hex 


191 


192 
196 
198 


BF 


Co 
C4 
C6 


Field Name 


AMDLRETR 


AMDLASPA 
AMDLNCIS 


AMDLNCAS 


AMDLEXCP 


AMDEXEXT 


AMDBCBNO 
AMDBFREE 
AMDFSBCB 


AMDFFBCB 
AMDCCWA 


AMDHERBA 


AMDCIMLT 


AMDRCFM1 


AMDIMPD1 
AMONCIFI 
AMDNCAF 1 
AMDSBLK1 
AMDSVAR1 
AMDSFIX1 


AMDFSEDB 


AMDLEDB 


Hex. 
Digit 


Description 


Local number of retrieved 
records 


Local bytes of free space 


Local number of control 
interval splits 

Local number of control area 
splits 


Local number of EXCPs issued 
by VSAM I/O routines 


Exception Exit 


Exception exit 


Buffer Mangement Information 


X'80' 
X'20' 
X‘10' 
X'04' 
X‘02' 
X'01' 


Number of buffers 
Number of unassigned buffers 


Address of the first BCB (for 
LSR: address of the BSPH) 


Address of the first free BCB 


Pointer to BKPHD, which is the 
first control block in the FCDB 
area. The rest of the FCDB 
area is divided into 64-byte 
FCDBs, which are suballocated 
as needed for CCB(s), CCW(s), 
FXL(s), and IOARG(s). 


High RBA of extent currently 
being processed, for SAM 
ESDS (Same value as 
EDBHIRBA) 


Cl multiplier, specifies the 
number of Cls that are to be 
considered as a CA in certain 
parts of Record Management 
processing. For a SAM ESDS, 
it has a value of one, otherwise, 
it has the same value as 
AMDCIPCA. 


Same as AMDRCFRM: zero if 
not a SAM ESDS. 
Same as AMDIMPF 


Same as AMDNCIFT 


Same as AMDNCAFT 
Same as AMDSBLKD 
Same as AMDSVAR 
Same as AMDSFIXD 


Reserved 


EDB Header 


Address of first EDB 
Reserved 
Length of EDB 


IFor more details of these fields, see the explanation of the AMDSB group occur- 





rence. 


Figure 5.45 Access Method Data Statistics Block (AMDSB) description and format 


(part 4 of 4) 
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Access Method Define the File (AMDTF) Table 
The AMDTF table, used by the ISAM interface program, is an extension to 
each ISAM DTF table which a VSAM data set is associated. It contains all 
the information necessary to process the VSAM data set that is not con- 
tained in the DTF table. The AMDTF table is contained in reformatted 
form in the core image library. It is loaded by IIPOPEN the first time an 
OPEN is issued for a file and is completed by IIPOPEN at this time. 


5.78 


Offset 
Dec Hex Bytes 


Field Name 


SAVARPP 


SAVARCI 


ACBAD 


RPLAD 
EREPL 


DTFISAD 
EPLRECAD 


EPLDASDA 


EPLRECID 


EPRLRECID 
EPLXREC 


EPLCXREC 
EPLMXREC 


EPLREAD 
EPLWRITE 


EPLCMNDC 


GENACB 


GACBHAD 
MACRFEAD 
FILENEAD 
GACBH 
GACBBTC 
GACBFTC 
GACBNOC 
GACBWAAD 


GACBWALN 
MACRFEL 

MACRFKTC 
MACRFVAL 


Hex. 
Digit 


Description 


Used to store register contents 
of problem program 


ISAM interface program save 
area 

Address of ACB 

X‘0A020000' 

(SVC2) 

Address of RPL 

Error exit parameter list (Valid 
only if ERREXT=YES is speci- 
fied in DTFIS.) 

Address of DTFIS 

Address of record in error (not 
supported by IIP) 

DASD address of record in 
error (not supported by IIP) 
Record identification 


Data record (VSAM data set) 
Index record (VSAM sequence 
set) 

Cylinder index record (VSAM 
index set) 

Master index record (VSAM 
index set) 

Read 

Write 


Command code of failing CCW 
(not supported by IIP) 


Unused 


GENCB information to generate 
the ACB 


Address of header 

Address of MACRF element 
Address of filename element 
Header 

Block-type code (ACB) 
Function-type code (GENCB) 
Number of copies (1 copy) 


Address of work area set to 0; 
VSAM obtains space via GET- 
VIS 


Length of work area 
MACRF element 


X'00120000' Keyword-type code 





Value supplied by IIPOPEN 


Figure 5.46 Access Method Define the File (AMDTF) table description and format 


(part 1 of 3) 
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Offset 
Dec Hex 


Figure 5.46 
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Bytes Field Name 


FNAMEEL 
FNAMEKTC 
FNAMEACB 
GENRPL 


GRPLHAD 
ARLNEAD 
ACBEAD 
KEYLNEAD 
RECLNEAD 
GRPLH 
GRPLBTC 
GRPLFTC 
GRPLNOC 
GRPLWAAD 


GRPLWALN 
ARLNEL 
ARLNKTC 
ARLNVAL 
ACBEL 
ACBKTC 
ACBAD1 
KEYLNEL 
KEYLNKTC 
KEYLNVAL 
RECLNEL 
RECLNKTC 
RECLNVAL 
SHOWCB 


SHHAD 
SHEAD 
SHH 

SHBTC 
SHFTC 
SHOTC 


Hex. 
Digit Description 


Filename (DDname) element 
X‘00090000' Keyword-type code 
Filename (inserted by IIPOPEN) 


GENCEB information to generate 
the RPL 


Address of header 

Address of AREALEN element 
Address of ACB element 
Address of KEYLEN element 
Address of RECLEN element 
Header 

Block-type code (RPL) 
Function-type code (GENCB) 
Number of copies (1 copy) 


Address of work area set to 0; 
VSAM obtains space via 
GETVIS 


Length of work area set to 0 

AREALEN element 
X‘'002D0000°' Keyword-type code 

Area length 

ACB element 
X'002BO0000' Keyword-type code 

Address of ACB 

KEYLEN element 
X'00300000' Keyword-type code 

Key length 

RECORDLEN element 
X‘'00350000' Keyword-type code 

Record length 


Information to show ACB or 
RPL 


Address of header 

Address of element 

Header 
X'00’ Block-type code 
X‘03' Function-type code (SHOWCB) 
X‘'0000' Object-type code 





Access Method Define the File (AMDTF) table description and format 
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5.80 


Offset 
Dec Hex 
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Bytes 


arononanan — 


nO 
oO 


o 


Field Name 


SHBAD 
SHARAD 
SHARLN 
SHAR 


SHEL 
SHKTC 
MODRPL 


MRPLHAD 
OPTCDEAD 
AREAEAD 
ARGEAD 
MRPLH 
MRPLBTC 
MRPLFTC 


MRPLBAD 


OPTCDEL 
OPTCDKTC 
OPTCDVAL 
AREAEL 
AREAKTC 
AREAAD 


ARGEL 
ARGKTC 
ARGAD 


MSGOUT 
MSCCB 
MSCCW 
ERRCDE 
ISAMCM 
ISCM 
VSAMCM 
VCCM 
CRCM 
CRC1 
SHOWCBF 
CRC2 
CRSCM 
CRSC 
BRKT 


Description 


Address of block to be shown 
Address of area 
Length of area 


Area where information is to be 
placed 


Element 
Keyword-type code (set by IIP) 


MODCEB information to modify 
the RPL 


Address of header 

Address of OPTCD element 
Address of AREA element 
Address of ARG element 
Header 

Block-type code (RPL) 
Function-type code (MODCB) 
Unused 


Address of block to be modi- 
fied (supplied by IIPOPEN) 


OPTCD element 


X'00340000' Keyword-type code 


Bit pattern (supplied by HIP) 
AREA element 


X'002CO0000' Keyword-type code 


Address of area (supplied by 
IP) 


ARG element 


X‘002E0000' Keyword-type code 


Address of ARG parameter 
(supplied by IIP) 


Header 

CCB 

CCW 

Error code of message 
‘SAM’ 

ISAM command area 
‘VSAM’ 

VSAM command area 
‘RCs 

Return code area 

Area if SHOWCEB failed 
Return code from SHOWCB 
‘EC= 

Error code area 
Closing bracket 
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BLDVRP Parameter List (BVRPPL) 


The BLDVRP parameter list contains all parameters needed by module 
IKQBRP to build the VSAM resource pool. The address of the parameter 
list is held in register 1. 


Offset Hex. 
Dec Hex Bytes Field Name Digit Description 


VRPBFLST Address of buffer list 


VRPKEYLN Maximum keylength in VSAM 
Resource Pool 


VRPSTRNO String number of VSAM 
Resource Pool 


6 Reserved 
VRP Buffer List 
The following 8 bytes are repeated for each subpool specified. 
12 Cc 4 VRPBFSZE Size of buffers in subpool 


16 10 1 VRPBFIND Indicator byte 
VRPBLEND X‘'80' End of buffer list 


17 «11 1 Reserved 
18 12 2 VRPBFCNT Number of buffers in subpool 
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Catalog Auxiliary Work Area (CAXWA) 


The CAXWA is built when the VSAM catalog is opened or is being created. 
The CAXWA is used to contain the addresses of control blocks and work 
areas needed when a catalog is being processed. The CAXWA also contains 
flags that indicate the type of processing being performed on the catalog and 
the component that invoked the processing. The CAXWA is pointed to by 
the ACB (ACBUAPTR). The AMCBS (CBSCAXCN) contains the address 


of the CAXWA chain. 


Offset 
Dec Hex 


Bytes and 
Bit Pattern Field Name 


CAXID 


CAXCHN 
CAXFLGS 


CAXBLD 
CAXOPN 
CAXCLS 
CAXEOV 
CAXCMP 


CAXMCT 
CAXCMR 


CAXSCR 
CAXFLG2 


CAXF2DT 
CAXF2NDD 
CAXF2CCR 


CAXF2CRA 
CAXF2REC 
CAXF2EOV 


CAXF2CA 


CAXACT 
CAXATIOT 
CAXSCHWA 
CAXDRWP 


Figure 5.48 
(part 1 of 2) 


Description 


Control Block identifier X'CA’ 

Reserved 

Address of the next CAXWA in the chain 
Flags: 


Build request 

The catalog is being opened 

The catalog is being closed 

An end-of-volume rountine is in control 
Open/Close/EOV processing is com- 
plete 

1=Master catalog 

O=User catalog 

Catalog management has been called by 
a catalog management routine 
Reserved for OS 

Flags: 

The catalog has been deleted 

No DLBL filename found 

O = CCR needs to be read 

1 = CCR has been read 

CAXWA for CRA 

Recoverable catalog 

End of volume flag 

Reserved for OS 

Free CAXWA if error 

Reserved 

Catalog activity count 

Reserved for OS 

Reserved for OS 


Address of the catalog’s VTOC label 
read work area 
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Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


CAXACB Address of the catalog’s ACB 
CAXCRACB __ Address of CRA’s ACB 

CAXUCB Address of the COMREG 
CAXCCR Catalog control record information 


CAXHACI Catalog interval number of the highest 
allocated control interval in the catalog 


CAXNFCI Control interval number of the next free 
control interval in the catalog 


CAXCDCI Number of deleted control intervals 


CAXFDCI Control interval number of the first 
deleted control interval in the catalog 


Reserved 


CAXRPLCT Number of RPLs associated with the 
CAXWA 


CAXRPL Address of the first RPL in the CAXWA's 
RPL chain 


CAXCNAM Catalog name 
CAXOPLST Open/Close parameter list: 


COPTS Option flags: 
CENLST End-of-list indicator 
XXX XXXX Reserved 


COPACB Address of the catalog’s ACB 
CAXOPEWA _ Address of Open/Close/EOV work area 
CAXCCA Address of the CCA 

CAXJDE Reserved for OS 


CAXCAT Address of the catalog’s ACB associated 
with CRA 


CAXVOLCR Volume serial of CRA volume 
CAXSYSCR SYS-number of CRA volume 


CAXVOLRM Voiume serial of volume containing CRA 
(at present not mounted) 


CAXSYSRM SYS-number of volume containing CRA 
(at present not mounted) 


CAXOCPAR O/C parameter list 
CAXOCACB ~~ ACB address 

CAXOCEOL _ End of list indicator (x‘'0A02’) 
CAXASPL Automatic assign parameter list 
CAXASVOL Assigned volume serial 
CAXASLUB Assigned logical unit 


CAXASFLG Automatic assignment flags 
CAXASGN Assignment required 
CAXNOCUU _— Don’t recommend a cuu in mount 
message 
XX XXXX Reserved 
2 CAXASCLT Device type and class for recommending 
cuu 


CAXASCL Device class 
CAXASTYP Device type 
CASFILNM File name for mount message 
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Catalog Communications Area (CCA) 


The CCA is built each time the CATLG macro instruction is issued to 
process a VSAM catalog record. The CCA contains information about the 
catalog being processed and about the catalog record and its extensions 
contained in each of the six buffers available to process the user’s request. 
The CCA is used to pass information between catalog management proce- 
dures. Register 11 contains the address of the CCA. Figure 5.50 shows the 
CCA description and format. 


Bit Pattern Fleld Name 


CCAID 
CCASZ 
CCACD1 
CCACD2 


CCAFLG1 

CCAF1LPS 
CCAF1ARA 
CCAF1LRD 


CCAF1KEY 


CCAF1KGE 


CCAF1CR 
CCAF1UP 
CCAF1DK 


CCAFLG2 
CCAF2SYS 
CCAF2NVC 


CCALIMCL 
CCAF2XEQ 


CCAF2RHS 


CCAF2COB 
CCAF2CO 
CCAF2CB 
CCAF2SMO 


Description 


Identifier - set to X‘'ACCA’ 
Size 

Return code 1 

Return code 2 


Flag byte 1: 

Stop the loop 

Assign RPL to auxilary record area 
Catalog control record read into virtual 
storage 

Retrieve.the catalog record based ona 
DSNAME value (GET) 

Retrieve by Cl number 

Retrieve the next catalog record (next 
GET) 

A checkpoint of the CCR required 

GET macro instruction issued for update 
When the caller is renaming a data set, 
this flag indicates that the data set's 
true-name record is to be deleted, but 


the data set’s catalog record is not to be 
deleted. 


Flag byte 2: 

Reserved for OS 

No validity check on the caller's CTGFL 
or work area is required 

Cylinder allocation 

Exclusive enqueue 

Shared enqueue 

When a catalog management routine 
calles the VSAM Open routines to opena 
newly created catalog, and the Open 
routines call VSAM Catalog Management 
routines to obtain information about the 
catalog to be opened, the situation is 
called a ‘recursive call’. The catalog 
cannot be dequeued when the Catalog 
Management routines return to the caller 
(VSAM Open routines). 

Combination of catalog open and build: 
Catalog is being opened 

Catalog open during build 

Reserved for OS 
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Bit Pattern Field Name 


CCAFLG3 
CCAEXGR1 
CCAGC4 


CCAGDSP 
CCAEXGR2 
CCANF 
CCAELC2 
CCALFT 
CCAEGREC 


CCAFLG4 
CCAF4DRQ 


CCAF4BYS 
CCAGVNC 


CCAGVNF 


CCAGVNBS 


CCAGVEX 
CCAGVNE 


CCATCOMP 


CCAFLG5 
CCAMEX2 
CCAMEX 
CCAMEX1 
CCAMODPA 


CCATHIT 


CCATEX 
CCATEX1 
CCATEX2 


Description 


Flag byte 3: 

Exit indicator 

The catalog record contains a password 
group occurrence (identified by Group 
Code 4) 

(detected during IGGPSCNC processing) 
GENDSP 

Exit indicator 

The group occurrence cannot be found 
Exit indicator 

First time 

Exit indicator 


Flag byte 4: 

The catalog must be dequeued after the 
request completes 

Bypass the security verification 

The required variable-length field is not 
completely contained in the record cur- 
rently in the buffer 

The group occurrence identified by the 
caller-specified sequence number can- 
not be found 

There is no buffer space available to 
contain an extension record 

Exit indicator 

The field does not exist in the located 
group occurrence 

Test complete: all group occurrence 
pointers have been examined and all 
designated fields have been tested 
Flag byte 5: 

Exit indicator 

Exit indicator 

Exit indicator 

The catalog record’s base record must 
be written (using IGGPPAD) into the cat- 
alog 

Successful test: a group occurrence has 
been found that satisfies the test condi- 
tions 

Exit indicator 

Exit indicator 

Exit indicator 
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Offset 
Dec Hex 
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Bytes and 


Bit Pattern Field Name 


CCAFLG6 
CCAMCODR 


CCADELP 
CCAMNOSP 


CCAINIT 
CCASUPFD 
CCAREUSE 


CCAEXT 
CCAMOD 


CCALAB 
CCALBLEN 
CCALBCYL 


CCARB 
CCADPL 


CCACPL 
CCAACB 
CCANPCCB 
CCAURAB 


CCASRCH 


CCASRID 
CCASRCIN 


CCARABO 


Description 


Flag byte 6: 

The catalog must be dequeued when the 
request completes 

A deleted group occurrence pointer was 
‘found 

The catalog record's free space isn't 
large enough to contain all the new cata- 
log information during the group occur- 
rence move operation 

Insert switch for variable-length field 
being retrieved 

Suppress password field information 
during field retrieval 

The contents of the caller's record areas 
(buffers) can be used by IGGPEXT and 
IGGPMOD 

Set when a catalog management routine 
calls the Extract routine (IGGPEXT) 

Set when a catalog management routine 
calls the Modify routine (IGGPMOD) 


Address of the label cylinder area 
Count field in units of 128 bytes 
Address field 


Pointer to RB 
Address of DADSM parameter list 


Address of the caller's CTGPL 

Address of catalog’s ACB 

Address of saved CAXWA 

Address of the record area block (RAB) 
currently in use 


Search argument (DSNAME of cluster, 
data, index, catalog, or nonVSAM data 
set, or a volume serial number) 


Control interval number 
Control interval number 
Reserved (or continuation of CCASRCH) 


Record Area Block 0: Each record area 
block describes the catalog record con- 
tained in one of the six catalog manage- 
ment buffers available for the request. 
RABs 1 through 5 are identical in format 
to RAB O. 


Note: ‘x’ in each field name is replaced 


by ‘0’ through ‘5’ to indicate a particular 
RAB’s field. 
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Offset 
Dec Hex 
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Bit Pattern Field Name 


CCARxFLG 


CCARxUR 


CCARxU1 


CCARxU2 
CCARxWR 


CCARxPA 


CCARxUPD 
CCARxRPL 


CCARxREC 
CCACPE1x 
CCARxSEG 
CCACPE2x 


CCACPE3x 
CCACPE4x 


CCARAB1 


CCARAB2 


CCARAB3 


CCARAB4 


CCARABS5 


CCARPLK 
CCARPLF 
LPINDX 

CCARPLX 


XIOOPT 
XIOGET 
XIOERS 
XIOARA 


XIOKEY 
XIONUP 
XIONCK 
XIOTNE 


XIOKGE 


XIOSEQ 


Description 


Flags: 

The first three flags are used by 
IGGPEXT and IGGPMOD: 

The RAB is in use. It cannot be used by 
IGGPEXT or IGGPMOD 

The RAB is temporarily in use by 
IGGPEXT or IGGPMOD. It cannot be ov- 
erlaid. 

(Same as CCARxU1) 

The buffer must be written before 
another catalog record can be read into © 
it. 

The buffer contains a new catalog 
record; PUT ADD is required to add the 
record to the catalog 

Reserved 

Update buffer not reused 

Last assign, RPL index 

Reserved 

Address of the record in the buffer 
Address of the record in the buffer 
Addresses of the segments 

Address of the first byte after the 
fixed-length header fields 

Address of the first group occurrence 
Address of the first free-space byte in 
the record 

Record Area Block 1 (See RAB O 
description) 

Record Area Block 2 (See RAB 0 
description) 

Record Area Block 3 (See RAB 0 
description) 

Record Area Block 4 (See RAB O 
description) 

Record Area Block 5 (See RAB 0 
description) 

Assigned RPL count 

Index to RPL found 

Loop indexing control (counter) 

Work byte for catalog RPL (mult.-use) 
1/0 options 

1=GET, O=PUT 

ERASE 

1=auxiliary record area required 
O=user record area required 
1=keyed required 

O=address required 

No update required 

No error check required 

1 =true name entry 

O=normal entry 

GET NEXT (GET) 

PUTSEQ (PUT) 
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Offset 
Dec Hex 


203 
204 
210 
212 
; 216 


216 
217 
218 


220 


220 


222 
222 
224 
226 
228 


348 


349 


350 


351 
352 
361 
364 
364 


365 
366 


367 
368 
372 
376 
380 


CB 
cc 
D2 
D4 
D8 


D8 
D9 
DA 


DC 


DC 


DE 
DE 
EO 
E2 
E4 


15C 


15D 


15E 


15F 
160 
169 
16C 
16C 


16D 
16E 


16F 
170 
174 
178 
17C 
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Bytes and 


Bit Pattern Field Name 


128 


—-= NONDND Ff 


XX XXXX 


PPh ht 


CCARPLT 
CCARPLAA 


CCARPL1 
CCADESA 


CCANDEXT 
CCAIXEXT 
CCASSVOL 


CCAEXTDE 


Description 


Work byte for catalog RPL (mult.-use) 
Indices to assigned RPLs 

Reserved 

Address of the RPL in use 


Save area for the extent information 
returned by VSAM, DADSM and Catalog 
Management: Suballocate 


Number of extents 
Extent index value 


Sequence number of the data set 
directory entry in the volume catalog re- 
cord 


Sixteen 8-byte extent descriptors: 


First extent descriptor 


CCAEXTSS 


CCAEXTAD 
CCAEXTCC 
CCAEXTHH 
CCAEXTTH 


CCAASCIK 
CCACRRP 


CCAASCIX 


CCASRPLX 
CCAASCI 
CCAUPGD 
CCAEQDQ 
CCAEDXFF 


CCAEDRLN 
CCAEDOPT 


CCAEDSHR 
CCARLSEB 


CCAEDRCD 
CCARTSAV 
CCACOMRG 
CCAEDUCB 
CCAMLRET 


Sequence number of the Data Space 
group occurrence that this extent’s 
space is a part of 


The extent's starting physical address: 
Cylinder number CC 

Head number HH 

Number of tracks in the extent 


Space for remaining 15 extent descrip- 
tors 


Number of control intervals required to 
satisfy the caller's request 


X‘80' Build ‘caller’ chain for message 
4223) 


Used by the ASSGN functions - points to 
the element in CCAASCI currently being 
processed. 


Saved RPL flags 

Number of each assigned control interval 
Control interval for UPG modification 
Enqueue/Dequeue parameter list 


End of parameter list, indicator byte 
=X'FF’ (if list is empty) 


Length of minor name 
Enqueue/Dequeue Options 


1=Shared, 0=Exclusive 
Reserved 
Other options (set by macro) 


Enqueue/Dequeue return code 
Save area for CCAMLRET 
COMRG pointer 

Work area 


Address of the caller's save area used 
by IGGOCLAG 
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Dec Hex 


384 
384 
388 
392 
393 
394 
396 
400 
400 


404 


180 
180 
184 
188 
189 
18A 
18C 
190 
190 


194 


Bytes and 


Bit Pattern Field Name 


=i 
Lv) 


eROAN ~*~ +~ & FA 


4 


CCAMSSPL 
CCAMNLEN 
CCAMNPTR 


CCAMNSPL 


CCARPRM 
CCACMS 
CCACMSWA 


CCAEXCMS 


Description 


GETVIS/FREEVIS parameter list area 
Number of bytes to process 

Address of the return address 

Reserved for OS 

Reserved for OS 

Reserved for OS 

Return parameters 

Catalog Management Services work area 


Address of the CMS calling routine’s 
work area 


Address of a secondary CMS work area 


The following fields are set and used by IGGPLOC, IGGPEXT, and IGGPTSTS, and catalog 
management subfunctions which these procedure call: 


408 
408 


412 
416 
420 
424 
428 


432 


436 
440 
442 


444 
448 


452 
456 


460 


198 
198 


19C 
1A0 
1A4 
1A8 
1AC 


1B0 


1B4 
1B8 
1BA 


1BC 
1C0 


104 
108 


1C0C 
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0 
4 


CCALUME 
CCACPES 


CCACPES1 
CCACPES2 
CCACPES3 
CCACPE6 
CCACPE61 
CCARABSE 
CCACPE7 
CCAIDPT 
CCACPE71 
CCAGOPLN 
CCASL 


CCAILNG 


CCAFLPT 
CCATFLPT 


CCARABPT 
CCADICT 


CCAXCPL 
CCAMCPL 


CCARABB 


CCARABF 


Address of a selected group occurrence 
pointer 


(Same as CCACPES) 

(Same as CCACPES5) 

(Same as CCACPES) 

Address of a selected group occurrence 
(Same as CCAPE6) 

Save extract caller URAB 

Address of field value 

Insert data address 

Alternate address to field value 

Length of the group occurrence pointer 


Length of sequence number field 
(RELREPNO) in the group occurrence 


Length of the selected retrieved field 
Address of the requested-field CTGFL 
Address of the CTGFL-for-tests 
Address of the record area block 
Dictionary information to describe the 
field, based on its field name 

Address of the CTGPL built when 
IGGPEXT and IGGPMOD are called, so 
that information in the caller's CTGPL is 
not altered 

Address of the RAB that identifies the 
base catalog record 

Address of the RAB that identifies the 
first record area (buffer) that can be 
used by IGGPEXT or IGGPMOD 
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Offset 
Dec Hex 


472 


476 


479 


480 


482 


484 


1D8 


1DC 


1DF 


1E0 


1E2 


1E4 


Figure 5.49 


VSE/VSAM VSAM Logic, Volume | 


Bit Pattern Field Name 


CCARABL 


CCACBASE 
CCAGC 


CCALREL 
CCALREL1 
CCASN 
CCASN1 
CCAFLG8 
CCARPUT 
CCALSTC 
CCAEXTCR 
CCABLDCR 
CCASPUCO 
CCASCAX 


CCAUPG 
CCABUF 


CCAFLGA 
CCAUPGRR 
CCARGET 


CCALBFVT 
CCACRARD 
CCAF1LSV 
CCACANIN 


CCAIXFPL 


CCAIXREL 
CCATNREL 


CCATNUM 


CCATREL 
CCATNO 


CCATEST 


Description 


Address of the RAB that identifies the 
last record area (buffer) that can be used 
by IGGPEXT or IGGPMOD 


The control interval number of the base 
catalog record 


Group code of the requested group 
occurrence 


Relative repetition number of a selected 
group occurrence 


Sequence number of a selected group 
occurrence 


CRA flags 

Inhibit CRA PUT/UPDATE 

Listcat request 

Extend CRA in process 

Open request for CRA build 

Special UCAT 

1=CRA CAXWA search, O= UCAT 
CAXWA search 

1 =upgrade, 0O=no upgrade 

Output buffering flag 

More flags 

RAB1 to be restored by upgrade module 
Get record for compare before update 
CRA 

Multiple file parameter search at define 
Indicate CCR for CRA has been reached 
Save indicator flag CCAF1LRD 

Cancel INHIBIT 

Reserved 


Index to the current CTGFL being 
processed 

Index for CCATREL 

The sequence number of the next group 
occurrence to perform tests against if 
CCATREL is full or if there are no buffers 
available to contain the catalog record's 
next extension 

Number of successful relative repetition 
numbers (cannot exceed 16) 
Successful relative repetition numbers 
Total number of successful! relative 
repetition numbers (might exceed 16) 
Address of the test CTGFL 
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Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


532 214 20 CCARBA Work area for extent descriptors 
532 214 2 CCASS Sequence number of the Data Space 
group occurrence that contains the ex- 
tent 
216 CCACCHH1 Physical address - CCHH - of the 
extent’s first track 
“ O1A CCACCHH2 s« Physical address - CCHH - of the 
extent’s last track 
21E CCATT Number of tracks in the extent 
220 CCARBA1 Low relative byte address (RBA) 
224 CCARBA2 High relative byte address (RBA) 
228 CCATLNG Total length of the extent information 
CCATLEN that has been processed (CCATLNG); 
total length of the scanned field so far 
(CCATLEN) 
CCARBAL RBA extent balance 
CCACNIX Combination name index 
CCAREASN Reason code 
CCAIDPT2 Address of the available space in the 
caller's work area or of the caller- 
supplied update information 
CCAIDPT3 Address of the length-field of a variable 
CCARABSM length field in the user’s return area 
CCAGVCT Number of group occurrence pointers 
processed so far 
CCANEVV If the requested variable-length field is 
non-existent, this field is set to binary 
zero 
CCAGVEXT Control interval number of the record’s 
next extension record (not yet in a buff- 
er) 
CCANEFV If the requested fixed-length field is 
non-existent, this byte is set to X'FF' 
CCADEF Define flags 
CCADED Define with DEDICATE 
XXX XXXX Reserved 


1 CCAGRGC Group code of the requested group 
occurrence 
2 CCAGRHI High relative repetition number 
CCAGRHI1 of the requested group occurrence 
CCAIXTPL Index to test FPL 
CCADLEN Number of bytes to be deleted from the 
catalog record 
CCADIFF The difference between the insert length 


and the delete length (can be a negative 
number) 
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Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


CCAREPCT Number of relative repetition numters 
processed so far 


CCADISP Displacement into variable-length field to 
the delete/insert location 


CCASVCI Save area for the control interval number 
of the base catalog record 


CCASVCI1 Save area for the control interval number 

CCADTA Address of the dictionary 

CCACDTA Address of the index combination table 

CCADTCT Number of dictionary entries 

CCACDTCT Number of index combination entries 

CCACWAP Controller work area 

CCAMNADR Address of the virtual storage obtained 
by a GETVIS request 

CCAILNG3 Save area for the insertion length 

CCAILNG2 Length of the user-supplied insert data 

CCAALPTR Address of the space management work 
area 

CCAGVLSV Address of GVL work area 

CCALCPL Reserved for OS 

CCAFLG7 Flags: 

CCALSP ' Reserved for OS 

CCANRLSE Release Control Bit 

CCACKDEL Delete switch 

CCASMFBR_ _ Do GET for base record 

CCAONCE Move only one occurrence 

CCAROREQ _~ Read only request 

CCAFEOV Force EOV 

CCAEQOPN ~~ Enqueued on SYSOPEN 

CCARCI CRA Record control interval number 

CCALABSV Saved address of IKQLAB area 

CCARABSV. Saved address of RAB 

CCAMODUL _ Last two bytes of module name 
(IGGOCLxx) 

CCACHAIN Control interval number save area 

CCACH Control interval number save area 

CCACI2 (Same as CCACI1) 

CCACI3 (Same as CCACI1) 

CCAVARLN Number of bytes to be inserted into the 
record 


CCARRAB Address of the RAB containing the group 
occurrence pointers where delete/insert 
processing is to begin 


CCARBASE (Same as CCARRAB) 
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Offset | Bytes and 
Dec Hex Bit Pattern Field Name Description. 


CCAVARPT Address of the information to be inserted 
into the record 


CCADELN Number of bytes to be deleted from the 
record 


CCAVAR Insert information save area 
CCAPIN MFG area for PIN 
CCAVARI1 (Same as CCAVAR) 


CCADEL1 The control interval number of the first 
record in a series of records to be delet- 
ed 


CCADEL2 The control interval number of the last 
record in a series of records to be delet- 
ed 


CCAXLATE Translation work area 
CCAR14S Register 14 save area 
CCABMINP Input parameters to IGGOCLBR 
CCABMTRK _ Starting track 

CCABMLIM Check limit, nn for set 
CCABMMIN Conditional check minimum 


CCABMFLG State and function code 
CCABMST This bit can be O or 1, and is the state 
for which an extent is to be checked (if 


bit 1 is on) or the state to which a map 
bit is to be set (if bit 2 is on) 
CCABMCHK ON - Perform check 
CCABMSET ON - Perform set 
CCABMCCK ON - Perform condition check 
CCABMLST ON - Last set request (write) 
Reserved 


Reserved 
CCABMOUT Output parameters from IGGOCLBR 
CCABMONN _ Track number 
CCABMOTR _ Starting track 
CCABMOFG = Output flags 


CCABMOST _ State of bits 
.XXX XXXX Reserved 





6 CCAVOLCR CRA volume identification 
1 CCABMPAD _ Padding character 
4 CCABMGOP Current bit mask GOP 
4 CCABMPTR _ Address of current bit mask byte 
4 CCABMEND _ End of current bit mask 
2 CCABMBT1 Bit count, first byte 
2 CCABMBTL Bit count, last byte 
2 CCABMBYT Number of full bytes 
2 CCABMSTR Current bit mask, start track 
4 CCABMWK1_ Work field 
4 CCABMWK2__—Work field 
Figure 5,49 Catalog Communications Area (CCA) description and format 
(part 10 of 12) 
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5.94 


Oftset 
Dec Hex 


816 
820 
824 
828 
832 
836 
840 
844 
848 
852 


856 


860 
864 
| 868 


330 
334 
338 
33C 
340 
344 
348 
340 
350 
354 


358 


35C 
360 
364 


Bytes and 


Bit Pattern Field Name 


PhD HP HH HHA HL 


oN 


> 


4 
8 


CCABMWK3 
CCABMWK4 
CCABMRB1 
CCABMRB2 
CCACARWA 
CCACRABF 
CCASACB 
CCAEXC 
CCASRPL 
CCAADBUF 


CCASCAXS 


CCASCAXA 
CCADEVT 
CCANMF3 


Description 


Work field 

Work field 

Address of first bit map RAB 
Address of second bit map RAB 
Address of CRA definition work area 
Address of CRA buffer 

Address of saved CCAACB field 
Save area for CCAACB 

Address of saved CCA, RPL field 


Address of cluster record buffer (cluster 
record saved until CRA volume known) 


Address of search argument for CAXWA 
chain search 


Address of found CAXWA 
CRA volume device type 
Save area for resource name 


The following two fields are used by the no-upgrade/upgrade function, called by ALTER, 


DEFINE or DELETE. 


876 
879 
882 
883 
884 
888 
892 
896 
900 
902 


36C 
36F 
372 
373 
374 
378 
37C 
380 
384 
386 


pop bh bh PP | |- DO W 


2 


CCAXDC! 
CCAXICI 
CCACATIN 
CCACPLSV 
CCACOPTR 
CCADEVA 
CCAFARE 
CCAAREA 
CCAMDSAV 
CCARSSAV 


AIX data control interval number 

AIX index control interval number 

CLAH indicator 

Catalog Parameter List options save area 
CLCO work area 

Address of device attribute return area 
Address of file identification 

Pointer to address of label record area 
Save area for CCA module 

Save area for CCA 


The following fields are used for converting block extents to track extents. 


904 
908 
912 
916 
920 
924 
928 
934 


388 
38C 
390 
394 
398 
39C 
3A0 
3A6 


Figure 5.49 
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4 


CCALIMST 
CCALIMED 
CCALIMBL 
CCALIMTR 
CCAFEXT 
CCAFSUCB 
CCAFVLID 


CCAFBFLG 
CCAFBTER 


CCAFBNRC 
CCAFBIN1 
CCALIMEN 
CCALIMRC 


Extent starting address 
Extent ending address 
Extent size in blocks 
Extent size in tracks 
Size of first extent 
UCB code save area 
Vol-ID save area 


Fixed block flags: 

Fixed block locate: device characteris- 
tics could not be retrieved 

Don't repeat IGGPXVAL 

FBA indicator 

More than one extent 

Recoverable catalog 

Reserved 





Catalog Communications Area (CCA) description and format 
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Offset 
Dec Hex 


935 


936 
936 
936 
937 
938 
939 
940 
944 
946 
948 
950 
960 
960 
966 
972 
976 
980 
981 
984 


3A7 


3A8 
3A8 
3A8 
3A9 
SAA 
3AB 
3AC 
3B0 
3B2 
3B4 
3B6 
3C0 
3C0 
3C6 
3CC 
3D0 
3D4 
3D5 
3D8 


Figure 5.49 
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Bytes and 


Bit Pattern Field Name 


1 


XX XXXX 
24 


=-2- 0+ BROOD AA“ NDNMNNFBBAHA AH DE 


CCAFBOPT 
CCAFBSPO 


CCAFDEVC 
CCAFBUCB 
CCAFUFG1 

CCAFUFG2 
CCAFUCLS 
CCAFUTYP 
CCAFBBLK 
CCAFBNCL 
CCAFBNTK 
CCAFBTSZ 


CCARNM 
CCAVOLSV 


CCADTL 
CCARNMP 
CCACNTL 
CCACISAV 


CCAFLG9 
CCADQSYS 
CCADQVOL 
CCADQDIC 
CCADSOPN 
CCADQOPN 
CCADQDIA 
CCADQNRQ 


CCACD3 


CCATEMPS 
CCAREGS 


CCAMODNM 
CCAACBSV 


CCACIND 
CCAEND 


Description 


Space options save area: 
Allocation unit 
Reserved 


Device characteristics save area: 
UCB code 

Operational characteristics 
Optional features 

Device class 

Device type 

Block size 

Number of cylinders 

Number of tracks per cylinder 
Number of blocks per track 
Reserved 

Resource name 

Temporary VOLID save area 
Reserved 

DTL pointer 

Resource name printer 
Control parameter work area 
Cl number save area 


Flags 

Unlock system resource 

Unlock volid resource 

Unlock ci# resource 

A data set is opened and locked 
Dequeue system OPEN resource 
Dequeue data/index for AIX 
Dequeue not required 

Reserved 


Return code save area 
Reserved 

Temporary area for PLS 
Save area for registers 
Address of user save area 
Load module name 
Reserved 

ACB pointer save area 
ci# save area 

End CCA 


Catalog Communications Area (CCA) description and format 
(part 12 of 12) 


Section 5. Data Areas 





D5 


Catalog Field Parameter List (CTGFL) 


The CTGFL is built before a user component issues the CATLG macro 
instruction to process a VSAM catalog record. The CTGFL defines one of 
the catalog record’s fields or a group of logically related fields (a combina- 
tion), The CTGFL is used in three situations: 


e Itidentifies a catalog record field to retrieve or update. The CTGPL 
contains the address of each CTGFL used in this way. 


e It identifies a catalog record field to compare against caller-supplied 
data. This is a ‘test’ CTGFL and is addressed by another CTGFL. 


e For update-extend processing, one or three FPLs identify the volume 
information group occurrence(s) to be extended. The catalog record 
fields identified by the CTGFL(s) are not explicitly retrieved or updated 
for the caller. 


When a catalog management routine is processing a CTGFL, the CTGFL’s 
address is in the CCA (CCAFLPT or CCATEST). 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


CTGFLDNO Number of entries in CTGFLDAT 


CTGFLDCD Test condition: 

The FPL describes a field to be updated 
or retrieved. 
The FPL is pointed to by the caller's 
CTGPL (CTGFIELD entry). 

not X'00' This FPL describes a test condition, and 
is pointed to by a request FPL. The 
codes for the test conditions are: 


X‘80' Equal 
Xx'60' Not equal 
X‘20’ Greater than 
i X'40' Less than 
ri X'AQ' Greater than or equal 
/ X'CO’ Less than or equal 
X‘80’ Test under mask for zeros 


Test under mask for ones 
Test under mask for mixed 


CTGFLDGC Group code number 


CTGFLDRE Test results: 
CTGFLFBA CKD device 





FBA device 
Reserved 
CTGFLDTS Successful test 
Test failed 
Figure 5.50 Catalog Field Parameter List (CTGFL) description and format 
(part 1 of 2) 
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Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


- CTGFLDWA Work area: contains information about 
the catalog record’s field name from the 
dictionary 


CTGFLDONM Address of the field name 


CTGFLCHN Address of next field macro or zero 


CTGFLDAT Combined name for data length and 
address 


CTGFLNG Data length of: 


CTGFLPT Address (in caller’s work area) of: 


e The field that was retrieved, if the 
request was LOCATE or CMS LIST- 
CAT, or 


New data to replace or add to data in 
the catalog record, if the request was 
UPDATE, CMS DEFINE or CMS AL- 
TER, or 


Data used to compare to catalog 
record fields, if the FPL is a FPL-for- 
tests. 





Figure 5.50 Catalog Field Parameter List (CTGFL) description and format 
(part 2 of 2) 


Catalog Field Vector Table (CTGFV) 
The CTGFV is built by the Access Method Services utility programs and 
contains addresses of user-supplied information fields and lists. The 
CTGFYV is built when the user issues a DEFINE or ALTER command. If 
the user is creating a cluster, a CTGFYV is built for each catalog record that 
will be built to describe the cluster, i.e., Access Method Services builds a 
cluster CTGFV, a data CTGFYV, and, if the cluster is key-sequenced, an 
index CTGFV. The CTGFV is pointed to by the CTGPL (CTGFVT). If 
Access Method Services builds more than one CTGFYV, the cluster CTGFVs 
are pointed to by the CTGPL (CTGFVT) and the data and index CTGFVs 
are pointed to by the cluster CTGFV. 
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5.98 


Offset 
Dec Hex 
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Bytes and 


Bit Pattern Field Name 


c=00 


~a000000 
DHD>< 


PPA PHA AL 


CTGFVTYP 


CTGFVDTA 
CTGFVCL 
CTGFVIDX 
CTGFVVOL 
CTGFVALN 
CTGFVAIX 
CTGFVPTH 


CTGFVPRO 


CTGFVAVL 
CTGFVRVL 
CTGFVNDC 
CTGFVIMP 


CTGFVELM 


CTGFVDCH 
CTGFVICH 
CTGFVVCH 
CTGFVIND 


CTGFVENT 
CTGFVSTY 


CTGFVOWN 
CTGFVEXP 
CTGFVCRE 
CTGFVVLT 
CTGFVRNG 
CTGFVDVT 


CTGFVSPR 
CTGFVSPC 


CTGFVAMD 


CTGFVFSN 


CTGFVATR 
CTGFVBUF 
CTGFVLRS 
CTGFVEXT 
CTGFVNAM 
CTGFVUPG 
CTGFVWKA 
CTGFVPWD 


Description 


The CTGFV contains information used by 
the CMS Define routines to build a cata- 
log record of the type: 


Data 

Cluster 

Index 

Volume (Space) 
Non-VSAM 
Alternate Index 
Path 


CMS processing option flags: 


ALTER: Add volumes 
ALTER: Remove volumes 
Device type converted switch 
Import request 

Reserved 


Element number of CMSPCATR 
Reserved 

Address of the cluster’s data FVT 
Address of the cluster’s index FVT 
Address of the space vector table 


Address of the associated DLBL state- 
ment 


Address of the 44-byte entry name 


Address of the security information FPL 
(passwords, codewords, and number-of- 
tries) 


Address of the owner identification FPL 
Address of the expiration data FPL 
Address of the creation date FPL 
Address of the volume serial number list 
Address of the key range list 


Address of the device type FPL (for 
nonVSAM DEFINE only) 


Address of space return information 


Address of the space allocation informa- 
tion FPL 


Address of the AMDSB FPL (if VSAM 
DEFINE) 

Address of the file sequence number (if 
NonVSAM DEFINE) 


Address of the data set attributes FPL 
Address of the buffer size FPL 

Address of the average record size FPL 
Address of exception exit 

Address of related object 

Address of FPL for 'RGATTR’ 

Address of CRA volume identification 
Relationship password 





Catalog Field Vector Table (CTGFV) description and format 
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Catalog Parameter List (CTGPL) 


The CTGPL is built before a VSE component issues the CATLG macro 
instruction to process a VSAM catalog record. The CTGPL defines the 
catalog management request and its options, the catalog record to be proc- 
essed, and the VSAM catalog that contains the record. The CTGPL is 
pointed to by register 1. When the catalog management routines build a 
CCA to support the request, the address of the CTGPL is put into the CCA 


(CCACPL). 


Offset 
Dec Hex 


Bytes and 
Bit Pattern Field Name 


CTGOPTN1 
CTGBYPSS 


CTGMAST 
CTGCI 
CTGUPD 
CTGREAD 
CTGNAME 


CTGCNAME 


CTGOPTN2 
CTGEXT 
CTGERASE 
GTFSMF 
GTGREL 


CTGPURG 
CTGVMNT 
CTGGTNXT 
CTGDISC 
CTGOVRID 
CTGSCR 
CTGDEALL 


CTGOPTN3 
CTGFUNC 
CTGSUPLT 


CTGSRH 


CTGNUM 
CTGAMO 


Figure 5,52 
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Description 


First option indicator: 

Bypass the catalog management security 
verification processing 

Check the master password 

Check the control interval password 
Check the update password 

Check the read password 

The CTGENT field contains the address 
of a 44-byte DSNAME, or a 6-byte vol- 
ume serial number (padded with binary 
zeros) 

The CTGENT field contains the address 
of a 3-byte control interval number ; 
The CTGCAT field contains the address 
of a 44-byte catalog DSNAME 

The CTGCAT field contains the address 
of a VSAM catalog’s ACB 

Reserved 


Second option indicator: 

Extend option (with UPDATE) 

Erase option (with DELETE) 

Write SMF 

Release (with UPDATE) Release second- 
ary extents when data set is opened as a 
reusable data set 

Purge option (with DELETE) 

Volume mount caller 

Get-next option (with LISTCAT) 
Disconnect option (with DELETE) 

Erase override option (with DELETE) 
Scratch space option (with DELETE) 
Deallocate all (RELEASE) 


Third option indicator: 

Specifies the caller-requested function: 
Super LOCATE 

Reserved 

Reserved 

Reserved 

VSAM request 

Non-VSAM request 
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5.100 


Offset 


Dec Hex 
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Bytes and 


Bit Pattern Field Name 


XX XXXX 


'D' 
r 
A 
U' 

y! 
C' 
M' 
G' 


n<D 


1 
C 
GC 
C' 
C 
C 
C' 
C 
C 
C 
C 
C 
1 


pS 


XX XXXX 
1 
4 


4 
4 
Variable 


CTGOPTN4 
CTGENT 


CTGFVT 


CTGCAT 


CTGCVOL 


CTGWKA 
CTGDSORG 


CTGOPTNS 
CTGDEFIN 

CTGALTER 
CTGDELET 
CTGLTCAT 


CTGCRFLG 
CTGLBCYL 
CTGCTRBL 


CTGTYPE 
CTGTDATA 
CTGTINDX 
CTGTALIN 
CTGTUCAT 
CTGTVOL 
CTGTCL 
CTGTMCAT 
CTGTAIX 
CTGTPTH 
CTGTUPG 
CTGTFREE 


CTGNOFLD 


CTGDDNM 
CTGNEWNM 


CTGFDBK 


CTGFBFLG 
CTGPAR 
CTGKEEP 


CTGJSCB 
CTGPSWD 


CTGDDUC 
CTGDDCR 
CTGFIELD 


Description 


Reserved for OS 


User entry address (address of volume in 
the case of OS) 

Address of callers CTGFV (DEFINE, 
ALTER) 


Address of the catalogs DSNAME or 
ACB, as specified in CTGOPTN1 


Catalog volume pointer - (Super 
LOCATE) 


Address of the callers work area 
Data set origin - (Super LOCATE) 


CMS options: 
DEFINE 
ALTER 
DELETE 
LISTCAT 
Reserved 


CRA open flags 

Label area information is passed for CRA 
Control blocks are passed for CRA 
Reserved 


Type of catalog record 
Data 

Index 
Non-VSAM 
User catalog 
Volume 
Cluster 

Master catalog 
Alternate index 
Path 

Upgrade set 
Free record 


Number of entries contained in 
CTGFIELD 


Address of DD-name 

Address of the new DSNAME, if the 
request is ALTER and the object’s name 
is being changed 

Super LOCATE feedback 

Super LOCATE flags 

Parallel mount - (Super LOCATE) 
Forced keep - (Super LOCATE) 
Reserved 

Reserved 

Reserved for OS 

Address of the caller supplied password 
Address of UCAT file name 

Address of CRA file name 

Field pointers 





Catalog Parameter List (CTGPL) description and format (part 2 of 2): 
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Close Work Area 
The Close Work Area is built when a VSAM data set is opened. It contains 
work area data for alternate index processing and save areas for close 
registers and catalog registers. It is pointed to by CLWAAD, displacement 
112 (X‘70’), in the Open Work Area during OPEN. After OPEN is com- 
plete, the AMBL field, AMBLCLWA, points to the close work area associat- 
ed with its ACB. 


Offset Bytes and 
Dec Hex Bit Pattern Fleid Name Description 


WAPASS Used to pass informaticn from OPEN to 
CLOSE 


WAEYCAT Eye catcher 


Job control disposition 
DISP=NEW 
DISP=OLD 

Reserved 

DISP =(,KEEP) 

DISP =(,DELETE) 
(DISP=(,DATE) 
Reserved 


DSATTRIB Data set attributes 

REUSE Defined reusable 

NOALLOC Defined NOALLOCATE 

WAIFPDF Defined implicitly 
Reserved 


EXPDATE Expiration date 
Reserved 
WAFEATSW __ Feature switches 


First Byte 
WAFDET Features determined 
.XXX XXXX Reserved 


Second Byte 
XXXX:- XXX, Reserved 
WAFSPMGT Space management feature in system 


Reserved 
WACOMACB ss Part common to all ACBs in close 
WAFLAG Flag byte: 
TCLOSE Work area for TCLOSE 
CLOSE Work area for Close 
OPEN Work area for Open 
OPAMDINX Index AMDSB is being processed 
VOLFOUND Volume serial number is in label cylinder 

record 
SSFLAG Sequence set with data 
RETRY Catalog should be reupdated by Close 
FILEPROT DOS Supervisor DASD file protect 
WAERCODE __ Error condition code 
WALEN Length of GETVIS area 
WAWORK1 General work field 
WALISTP Address of user ACB/DTF list 
WACOMR Address of partition COMREG 
WADSAAD Address of dynamic save area 
WADSALN Length of dynamic storage area (DSA) 
EDBCODE Code to remember EDBs/GETVIS 
Reserved 


-aA -+-~ nN fF APH APD = 





Figure 5.53 Close Work Area description and format (part 1 of 3) 
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Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


| CATEXTPT _ Pointer for extents 
CATEXTLN Length of total extents 
EXTNUMB Number of extents 
USERSAVE Room to save user jobname, PSW, and 
registers (from partition save area) 
Reserved 
PARM Parameter list for IKQOCSHR 


WAOPCODE = Operation code used for determining 
function 

DSID Data set ID 

DSCI Cl number 

CTACBPTR Pointer to catalog ACB 

SHAREOPT Share option from catalog 

WASHR1 Share option.1 file 

WASHR2 Share option 2 file 

WASHR3 Share option 3 file 

WASHR4 Share option 4 file 
Reserved 


WAPFLAG Option flags 

WAPOUT 1 - lock/unlock for output access 
0 - lock /unlock for input access 
Reserved 


OUTCNT Indicator of output user count 


WAOCDTL Area to contain DTL (must be large 
enough to hold MAPDTL) 


WACOMEND __ End of common work area 
WORKAREA _ Close work area 

TIME Time used to update catalog 
CLWRET1 Return address of savearea 1 
CLWRET2 Return address of savearea 2 





Figure 5.53 Close Work Area description and format (part 2 of 3) 
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Offset 
Dec Hex 


218 DA 
220 DC 


228 E4 

232 E8 

236 EC 

308 134 
308 134 
380 17C 
380 17C 
384 180 
386 182 
388 184 
392 188 
392 188 
444 1BC 
460 1CC 
1032 408 
1096 448 
1148 47C 


Figure 5.53 
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Bytes and 


Bit Pattern Field Name 


XXX XXKX 


BITBANK 
ENQACT 
ENQOPN 


SETOFLG 


CLAIXWA 
ACBREQ 


ACBBASE 
USBADDR 
ACBCURR 


RPLCURR 


AIXATTR 
AIXUPGRD 


AIXBASC 
AIXENTRY 


AIXPROC 
UPGD2 


CLMSGFLG 


FTAB 


USBCURR 
SAVEPTR 
REGSAVE 
CATSAVE 
CLWTEMP 
CATDATA 
CATLSTP 
CATLSTSZ 
CATWASIZ 


CATWAPTR 


CATWA 


DUMMYRPL 
DUMMY234 
DUMMYPLH 


DUMLSRA 
DUMDBHD 
DUMIBHD 


Description 


Close flags 

USE macro was issued 
Enqueue on SYSOPEN 
Reserved 


Byte of zero for resetting OPEN indicator 
Reserved 
AIX work area 


Address of ACB for which 
CLOSE/TCLOSE is requested 


Address of base cluster ACB 
Address of USB 


Address of ACB currently being proc- 
essed 

Address of header RPL 

AIX attribute of current ACB 

Member of upgrade set but not path 
entry 

Base ACB 

Path entry ACB 

Reserved 


Processing status 

First member of upgrade set has been 
processed 

Reserved 


IKQOCMSG flags 


Resource name field for protection of file 
tab 


Address of current USB ACB 
Pointer to save area 

Close register savearea 
Catalog register savearea 
Temporary work area 


- Catalog data 


Address of catalog list 
Catalog list size 

Catalog work area size 
Address of catalog work area 
Catalog work area 

Dummy RPL 

Save area for registers 2 - 5 
Dummy PLH for LSR 

LSR savearea 

Dummy data buffer header 
Dummy index buffer header 





Close Work Area description and format (part 3 of 3) 
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DADSM Parameter List 


5.104 


The DADSM parameter list contains the information required by the 
DASD Space Management modules. Its address is held in register 1. 


Offset 
Dec Hex 
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Bytes 


o 


NnNOowr PF AR FH] PD 


ie) 
> 


Field Name 


DADVOLID 
DADSYSLN 
DADSFLAG 


DADRF1 
DADFR4 
DADRADDR 
DADBYPS 
DADNEXT 
DADLKLBL 
DADSPROT 
DADSHR 


DADSVTOP 
DADSMSG 
DADSNOP 
DADSFBA 
DADSCNCL 


DADSRC 
DADCODEA 
DADSLADD 
DADSAREA 
DADEXIST 
DADSRDSN 
DADCOV1 
DADCREAT 
DADCOV2 
DADSEXIT 
DADSWORK 
DADSWA 
DADPARM1 
DADSAVE 
DADPARM2 
DADATE 
DADFLPTR 
DADBLPTK 
DADALU 
DADCVHPL 


Description 


Volume identifier 
Number of system LUB 
Processing flags 


First byte: 

Read format 1 label 

Read format’ 4 label 

Address for read 

Bypass volume 1 checking 

Get next label 

IKQLAB has been called 
Scratch/rename protected files 
Shared VTOC access 


Second byte: 

VTOC open indicator 
Message flag 

Bypass VTOC open 

Fixed block device 
Operator reply was cancel 
Reserved 

Reserved 

Reserved 


DADSM return code 

Return code save area 
Address of label record 
Address of |/O area 

Old data set name 

Returned data set name 
Check for overlaps return area 
New data set name 

Check for overlaps return area 
DADSM exit address 

Work area 

Work area 

Parameter 1 

Save area for scratch 
Parameter 2 

Date 

File pointer 

Number of blocks per track 
Round allocation to this unit 
CVH parameter list 





DADSM Parameter List description and format 
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Define the File Indexed Sequential (DTFIS) Table 


The DTFIS table is provided by the user program and contains all the 
information needed to process a specific ISAM file. Part of it is used by IIP 
when a VSAM data set is to be processed by an ISAM program. If this is 
the case, the DTFIS table is reformatted at OPEN time by IIPOPEN. 


Offset Hex. 
Dec Hex Bytes Field Name Digit Description 


DTFCCB 
DTFCCBB2 
ERREXT 
FLAGBYTE 
AMODTF 


LOGMODAD 


FILETYPE 
LOAD 
ADD 
RETRVE 
ADDRTR 


OPTIONS1 
BLKDRECS 


FNAMEDTF 
OPTIONS2 
FNAMEC 

LOAD files: 


UNCIOERR 
WRGLEN 
PDARFULL 
CYLXFULL 
MASXFULL 
DUPREC 


SEQCHECK 
PDAROVFL 


Accept physical |/O error 


VSAM bit (set to 1 if DTF 
belongs to a VSAM data set) 
Assign ‘ignore’ bit 

Address of logic module; if 
AMODTFE is set to 1, then ad- 
dress of branch vector 


File type 

LOAD-type DTF 
ADD-type DTF 
RETRIEVE-type DTF 
ADD-RETRIEVE-type DTF 


Options byte 1 (ISAM options) 
Blocked records 


File name (DDname) 
Options byte 2 (not used by IIP) 
Status byte 


Uncorrectable DASD I/O error 
Wrong length record (not used 
by IIP) 

No more VSAM data space 
available 

No more VSAM data space 
available 

No more VSAM data space 
available 

Duplicate record 

Sequence check 

Prime data area overflow (not 
used by IIP) 





Figure 5.55 Define the File Indexed Sequential (DTFIS) table description and format 
(part 1 of 3) 
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5.106 


Offset 
Dec Hex 
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Hex. 


Bytes Field Name Digit 


Non-LOAD files: 
UNCIOERR : 
WRGLEN 


EOF 
NORECFND 
ILLEGID 


DUPREC 
OFARFULL 


OVFLREC 


RTRBYTE 
WORKR 


WORKS 


AMDTFAD 
CIPROCAD 
SAVERG 
PPRETAD 


RECLOC 


CISWITCH 


WNKA 
RKWK 
RK 
FIWRITE 
FIWOK 
LD 


LRECLEN 
KEYLEN 


KEYLOC 
KARGAD1 


DSPLPRT2 


DSPLPRT3 


Description 


Uncorrectable DASD 1/O error 
Wrong length record (not used 
by IIP) 

End of file 

No record found 

Illegal identifier specified (not 
supported by IIP) 

Duplicate record 

No more VSAM data space 
available 

Overflow record (RETRVE) (not 
used by IIP) 


Not used by VSAM 
RETRVE byte 

WORKER set to 1 if WORKR 
specified 

WORKS set to 1 if WORKS 
specified 

Address of AMDTF 
Address of IIP processor 
Save area for one register 
Return address to problem 


program if called from a $$B 
phase 


Address of record for LOAD 
IOREG 

IP switches 
Write-new-key-add bit 
Read-key-write-key bit 
Read-key bit 

First write after SETFL 

First write is all right 

LOAD 

Not used by VSAM 

Logical record length 

Key length 

Not used by VSAM 

Key location (not used by HIP) 
Address of KEYARG, moved 
from part 2 by 1IIPOPEN if RTR 
SEQ with KEY (POINT) or RTR 
RAN is specified 
Displacement of part 2 (ADD, 
RTR) 


Displacement of part 3 (ADD, 
RTR) 





Define the File Indexed Sequential (DTFIS) table description and format 


(part 2 of 3) 


Licensed Material — Property of IBM 


Offset 
Dec Hex 


Figure 5.55 
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Hex. 


Bytes Field Name Digit 


LDIOREGS 


LDIOREGR 


WORKAD1 


lIOASAD1 


SAVAR1 


IORLAD 
DATIWLAD 


KEYIWLAD 


MIXEXTI 
CROREXT 


WORKLAD 


KLM1 
Part 2 of OTF 


IOASAD2 
IOARAD 
KARGAD2 
WORKRAD2 
CURIOAAD 


LIOREGS 


NTAGRECS 


LIOREGR 
Part 3 of DTF 
SAVAR2 


Description 


For RTR SEQ: if WORKS=1, 
then NOP; if WORKS=0, then 
L tOREG, RECLOC 


For RTR RAN: If WORKR=1; 
then NOP; if WORKR=o, then 
L 1IOREG, RECLOC 


Address of WORKR moved 
from part 2 


Address of IOAREAS moved 
from part 2 


For LOAD-type DTF, save area 
for IIPOPEN 


Address of IOAREAL for LOAD 


Address of data in WORKL for 
LOAD 


Address of key in WORKL for 
LOAD 


Not used by VSAM 
Extend indicator for LOAD 


Extending file 
Creating file 


Not used by VSAM 

Address of WORKL for ADD 
Not used by VSAM 
KEYLEN-1 for LOAD 


Not used by VSAM 
Address of IOAREAS 
Address of IOAREAR 
Address of KEYARG 
Address of WORKR 


Address of current sequential 
1/O area 


LIOREG, *-4 or NOP (RTR 
SEQ) 


Not used by VSAM 


Number of records tagged for 
deletion 


LR IOREG, ) or NOP(RTR RAN) 


Save area for IIPOPEN, not 
LOAD type 





Define the File Indexed Sequential (DTFIS) table description and format 


(part 3 of 3) 


Section 5. Data Areas 5.107 


Extent Definition Block (EDB) 
The EDB describes all extents of the space allocated to the cluster’s data set. 
The EDB is built by the Open module from information in the data set’s 
catalog record. The AMDSB contains the length of the EDB (AMDLEDB), 
the number of EDB entries (AMDNEDB) that follow the header, and the 
address of the first EDB (AMDFSEDB). Each EDB entry describes an 
extent, and contains the address of the associated LPMB. 


Offset Hex. 
Dec Hex Bytes Field Name Digit Description 


EDBNEDB Address of next EDB 

EDBSYMU Symbolic unit (for CCB) 

EDBSUCLS Symbolic unit class 

EDBSUNUM Symbolic unit number 

EDBNUMTR Number of tracks of extent 

EDBFLGS Flags 

EDBDWSS ‘80' Data RBA with sequence set 

EDBSSWD ‘40’ Sequence set RBA with data 

EDBIXREP ‘20' Index replication 

EDBMNT ‘10’ Volume mount flag 

EDBLGCC ‘08' Device contains more than 256 
cylinders 

EDBRPS ‘04’ Indicator for RPS device 


EDBARCH ‘02’ Extent is on a fixed block 
device 


EDBMBB Extent (M) and bin (BB) number 
EDBM Extent (M) number 
EDBBB Bin (BB) number 


EDBLBBBB Starting biock of a fixed block 
extent 


EDBXTNT Combined name for low and 
high CCHH 

EDBLCCHH Low cylinder and head num- 
bers 

EDBLCC Lowest cylinder 

EDBLHH Lowest head 

EDBHBBBB Ending block of a fixed block 
extent 

EDBHCCHH High cylinder and head 
numbers 

EDBHCC Highest cylinder 





Figure 5.56 Extent Definition Block (EDB) description and format (part 1 of 2) 
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Offset Hex. 
Dec Hex Bytes Field Name Digit Description 


EDBHHH Highest head 

EDBLPMBA Address of associated LPMB 
EDBPARDB Address of ARDB 

EDBVLSQ Index to the VOLSER list 


EDBSTTRK Relative track address of the 
start of the extent (zero for fix- 
ed block devices) 

EDBRBAS Combined name for low and 
high RBAS 

EDBLORBA Low RBA limit 


EDBHIRBA High RBA limit 


EDBTLBCA Total number of data blocks 
and sequence set blocks per 
CA, minus 1 (fixed block de- 
vices). 

EDBCASZ Number of bytes per control 
area 

EDBTRKCA Number of tracks per control 
area 

EDBTPBCA Total number of data blocks, 
sequence set blocks, and wast- 
ed blocks per CA (fixed block 
devices). 





Figure 5.56 Extent Definition Block (EDB) description and format (part 2 of 2) 
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Open ACB List (OAL) 


The OAL is a list which contains all VSAM ACBs that have been opened. It 
is built by IKQOPN. The addresses of the ACBs are also entered by 
IKQOPN. OAL entries are deleted by IKQCLOO00 and $$BACLOS. The 
field at displacement X‘0C’ of the Anchor Table contains the address of the 


OAL. 


One OAL contains 16 bytes of “header” information plus | to 14 8-byte 
fields, each representing an open ACB. If there are more that 14 open 
ACBs, another OAL header is created, along with entries for the additional 


ACBs. 


Offset 


Dec Hex Bytes Fleld Name 


OALID 
OALIDD 


OALLEN 
OALNOAL 


OALNOPN 


OALNENT 


OALENTRY 
OALACB 
OALSVC 


OALFLG 
OALACT 


OALCICHK 


Figure 5.57 
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Description 


OAL identifier 
OAL identifier equate 


Reserved 

Length of this block (128) 
Pointer to next OAL (if more 
than 14 ACBs exit) 

No. of open data sets in the 
partition 

No. of OAL entries (14) 
Reserved 

Entry description (repetitive) 
Address of opened ACB 
Delimiter (X‘'0A’) 

Flag byte 

ACB is open 


Vaiue to check validity of 
control interval number of data 
set in catalog. Value is formed 
at open time by adding the 
third byte of AMDDSM to the 
first two bytes of AMDDSM. 





Open ACB List (OAL) description and format 


Licensed Material — Property of IBM 


Open Work Area (OPNWA) 


The Open Work Area is built when a VSAM data set is opened or is being 
created. It contains the addresses of control blocks and work areas needed 
when a data set is being opened. The Open Work Area also contains flags 
that indicate the type of processing being performed on the data set and the 
address of the SVC that invoked the processing. The Open Work Area is 
pointed to by the AMBL and register 4 (RWKA) during open. 


Offset 
Dec Hex 


Bytes and 


Bit Pattern Field Name Description 


Licensed Material — Property of IBM 


XXX XXX 


XXXX XXX. 


WAPASS 


WAEYCAT 
DISP 

NEW 

OLD 


KEEP 
DELETE 
DATE 


DSATTRIB 
REUSE 
NOALLOC 
WAIFPDF 


EXPDATE 


WAFEATSW 


First Byte 
WAFDET 


Second Byte 


WAFSPMGT 


WACOMACB 
WAFLAG 
TCLOSE 
CLOSE 
OPEN 
OPAMDINX 
VOLFOUND 


SSFLAG 
RETRY 
FILEPROT 


WAERCODE 
WALEN 
WAWORK1 
WALISTP 


Used to pass information from OPEN to 
CLOSE 


Eye catcher 


Job control disposition 
DISP=NEW 
DISP=OLD 

Reserved 
DISP=(,KEEP) 

DISP =(,DELETE) 
DISP=(,DATE) 
Reserved 

Data set attributes 
Defined reusable 
Defined NOALLOCATE 
Defined implicitly 
Reserved 


Expiration date 
Reserved 
Feature switches 


Features determined 
Reserved 


Reserved 

Space management feature in system 
Reserved 

Part common to all ACBs in close 
Flag byte: 

Work Area for TCLOSE 

Work Area for Close 

Work area for Open 

Index AMDSB is being processed 
Volume serial number is in label area 
record 

Sequence set with data 

Catalog should be reupdated by Close 
DOS Supervisor DASD file protect 
Error condition code 

Length of GETVIS area 

General work field 


Address of user ACB/DTFE list 





Open Work Area (OPNWA) description and format (part 1 of 8) 
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Offset 


Dec 


32 
36 
40 
42 
43 
44 
48 
50 
52 


132 
140 
140 


141 
141 
144 
148 


149 


150 
152 


176 
176 


176 


180 


184 


188 


189 


192 
196 
200 


Hex 


20 
24 
28 
2A 
28 
2C 
30 
32 
34 


84 
8C 
8C 


8D 
8D 
90 
94 


94 


96 
98 


BO 
BO 


BO 


84 


B8 


BC 


BD 


Co 
C4 
C8 


Figure 5.58 
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Bytes and 

Bit Pattern Fleld Name 
4 WACOMR 
4 WADSAAD 
2 WADSALN 
1 EDBCODE 
1 
4 CATEXTPT 
2 CATEXTLN 
2 EXTNUMB 
80 USERSAVE 
8 
12 PARM 
1 WAOPCODE 
7 DSID 
3 DSCI 
4 CTACBPTR 
1 SHAREOPT 
Tones WASHR1 
se WASHR2 
pelle ee WASHR3 
gaa Moe WASHR4 
seve XXXX 
1 WAPFLAG 
Ndescne WAPOUT 
Olea 
XXX XXXX 
2 OUTCNT 
24 WAOCDTL 
fe) WACOMEND 
0 OWA 
4 WAVSLOD 
4 WAIKQLAB 
4 CLWAAD 
1 LBLRCLEN 
3 LABICPTR 
4 SVCATACB 
4 CTGPLPTR 
4 CATWKPTR 


Description 


Address of partition COMREG 
Address of dynamic save area 
Length of dynamic storage area (DSA) 
Code to remember EDBs/GETVIS 
Reserved 

Pointer for extents 

Length of total extents 

Number of extents 

Room to save user jobname, PSW, and 
registers (from partition save area) 
Reserved 

Parameter list for IKQOCSHR 
Operation code used for determining 
function 

Data set ID 

Cl number 

Pointer to catalog ACB 

Share option from catalog 

Share option 1 file 

Share option 2 file 

Share option 3 file 

Share option 4 file 

Reserved 

Option flags 

1 - lock/unlock for output access 

0 - lock/unlock for input access 
Reserved 

Indicator of output user count 


Area to contain DTL (must be large 
enough to hold MAPDTL) 


End of common work area 


Partial map of work area obtained by 
GETVIS issued by $$BOVSAM 


Address of location where VSAM has 
been placed by CDLOAD (set by 
$$BOVSAM) 


Address of location where IKQLAB has 
been placed by CDLOAD (set by 
$$BOVSAM) 


Close work area address saved 


Length of work area pointed to by 
LABICPTR in multiple of 128 


Pointer to work area reserved for label 
record 


Pointer to catalog ACB 
Puinter to catalog parameter list (CPL) 


Pointer to catalog work area (CTGWA) 
(contents moved to CPL) 


Open Work Area (OPNWA) description and format (part 2 of 8) 
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Bytes and 
Bit Pattern Field Name Description 


4 OLDEDB Address of EDB 
4 NXTEDB Address of next EDB 
Catalog Field List for AMDSB 


212 D4 0 FLAMDSB Catalog field list work area (CTGFLDWA) 
for AMDSB 


212 D4 SAVERET1 Pointer to contents of return register (R 
14) if not catalog call 


212 D4 RETREG1 Return address to save area 1 
216 D8 SAVERET2 Return address to save area 2 
216 D8 RETREG2 Return address to save area 2 


220 DC FLAMDSBN Pointer to catalog field name 
AMDSBCAT 


220 DC RETREG3 Return address to save area 3 

224 EO * Next CTGFLCHN number 

228 E4 FLAMDSBL Length of AMDSBCAT 

232 E8 FLAMDSBA Address of AMDSBCAT 
Catalog Field List for Volume Entry(ies) 

236 EC 8 FLENTVOL 


236 EC 2 KRNKEYS No. of key ranges equals number of 
ARDBs 


238 EE KRNVOLS Number of volumes for this key range 
241 F4 FLVOLNTN Volume entry name ENTVOL 
248 F8 y 
248 F8 SVLENG Length of ENTVOL 
252 FC VOLENTLN Length of volume entry 
256 100 VOLGPPTR Address of ENTVOL data 
Catalog Field List for Data Set Attributes 
260 104 20 : DSATTR field list 
280 118 4 FLDSATRA Base of DSATTR 
Catalog Field List for Open Indicator 
284 11C FLOPNIND Locate OPENIND and test for UPD 
292 124 FLOPNINN Open indicator field list 
296 128 Chain 
300 12C FLOPNINL Length of OPENIND 
304 130 FLOPNINA OPENIND address 
Catalog Field List for Minimum Buffer Size 
308 134 20 : Flags, etc., for BUFSIZE 
328 148 4 FLBUFSZA Base of BUFSIZE 
* Multi-use field 





Figure 5.58 Open Work Area (OPNWA) description and format (part 3 of 8) 
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Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


Catalog Field List for High-Used RBA per Data Set 
332 14C 20 * Miscellany for HURBADS 


332 14C 20 NVOLLIST No. of volumes per key range (Space for 
10 two-byte entries) 


352 160 4 FLHURDSA Base for HURBADS 
356 164 20 * CATFILE field list 
376 178 4 FLFILTA Base for CATFILE 

Catalog Field List for Names of Related Data Sets 
FLNAMEDS Flags for NAMEDS 
PARMLIST IKQVLAB parameter list 
PARM1 ACB DD name 
PARMLEN Length of work area for IKQLAB 
PARM2 Pointer to ‘LABICPTR’ 
FLNAMDSN Pointer to ‘NAMEDS' 


* 


380 17C 
380 17C 
380 17C 
384 180 
385 181 
388 184 
392 188 
396 18C 
400 190 


FLNAMDSL Length of associated names 
FLNAMDSA Address of NAMEDS groups 
Catalog Field List for Entry Type and Control Interval No. 
404 194 ‘ CTGFLDWA for this field list 
412 19C FLMISCLN Pointer to ‘DSTYPNAM' 
416 1A0 " Chain 
420 1A4 FLMISCLL Length of DSTYPNAM 
424 1A8 FLMISCLA Address of DSTYPNAM 
Catalog Field List to Find Catalog ACB Address 
428 1AC 20 FLCATACB Field list #10 for catalog ACB 
448 1C0 4 FLCTACBA Pointer to catalog ACB pointer 
452 104 20 FLEXPDT Field list #11 for expiration date 
472 1D8 4 FLEXPDTA Pointer to expiration date from catalog 
Catalog Field List to Test for Write of Open Indicator 
476 1DC FLWOPNND ~~ Update OPENIND field list 
476 1DC TSTENTVL Address of test ENTVOL (scan) 
480 1E0 TSTENTLN Address of end scan ENTVOL 
484 1&4 FLWOPNNN Pointer to ‘OPENIND' 
488 1E8 . Chain 
492 1EC FLWOPNNL Length of data 
496 1FO FLWOPNNA _ Pointer to data 
Catalog Field List for Volume Time Stamp 
500 1F4 24 FLTMSTVF VOLTSTMP field list 
500 1F4 20 . Greater part of field list 
520 208 4 FLTMSTVA Pointer to ‘VOLTSTMP’ 


PHA HR WO + FH WO OW 


* Multi-use field 





Figure 5.58 Open Work Area (OPNWA) description and format (part 4 of 8) 
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Offset 
Dec Hex 


Bytes and 


Bit Pattern Field Name Description 


End of Catalog Field List for Volume Time Stamp 


Figure 5.58 
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XXX XXXXK 


WARNFLG 
WAENTID 
LIMIT 


RELGP 
TEMP 
IARDB 
SAVDEV 
SAVDEV2 
SAVTRKAU 


SAVTRKA2 


RLPMB2 
OWAFLAGS 


OWFLAGZB 
OWFLAGBF 
OWFLAGIB 

WARSOPEN 


DTACNT 


IDXCNT 


INDEXSAV 
SAVTYPE 


TESTSV1 
SVOPNIN 
SVOPNINO 


SVNEXTNT 
SETNBUF 
VOLSTPTR 
VOLENTND 
VOLENTCT 
IVOLS 


Used to save warning error code 
Entry ID (Catalog CI#) 


Count of the ENTVOLS pointed to by 
VOL20PT 


Relative group number in the catalog 
Local calculations (on same listing page) 
Index for ARDB list 

Used to save device type 

Used to save sequence set device type 


Used to save number of tracks per 
allocation unit (control area) to help 
identify type of LPMB 


Same as SAVTRKAU but used only if 
sequence set with data 


Pointer to sequence set (index) LPMB 
Open flags and switches 


User did not specify buffer size in ACB 
BCB building in process 


Got buffer with AMBL for index 

USE macro has been issued for SYSO- 
PEN (RELEASE macro must subsequent- 
ly be issued) 

Open count in look-aside table is 
bumped for data 

Open count in look-aside table is 
bumped for index 

Reserved 

Used to save index file name 

Used to save entry type when entry is 
not a cluster 

Reserved 

Save a word for testing 

Updated OPENIND for catalog 

Flag open for output 

Reserved 

Save number of EXTENT statements 
Count of buffers (used by SETADDR) 
Address of volume list 

End of all ENTVOLS 

Count of volume entries 

Working index of ENTVOLs 





Open Work Area (OPNWA) description and format (part 5 of 8) 
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5.116 


Offset Bytes and 
Dec Hex Bit Pattern Field Name Description 


580 244 VOL20PT Pointer to volume entries to sort 
(address of VOLENT20 if less than 20) 


584 248 VOLENT20 Volume entries to sort 

664 238 VMTPTR Pointer for right VOLSER 

668 29C REQBUFSP Minimum buffer space required 

672 2A0 CURBUFSP Currently specified buffer space 

676 2A4 CURBFSPD Current buffer space specified for data 


680 2A8 ADDAREA Room to add without current specifica- 
tions for index 


CURBFSPI Current buffer space specified for index 
WRKCINV Working value of Cl 
SVLUBPUB Save index of PUB 
NEXTJIB Next JIB saved 
SVPUB LUBs for mounted volumes 
IPUB Index for SVPUB 
OWAPRTCT Room to build password 
Unused 


680 2A8 
684 2AC 
688 2BO 
689 2B1 
690 2B2 
700 2BC 
702 2BE 
710 2C6 
712 2C8 DUMCATPL Room for catalog parameter list 
792 318 OWACTWKA _ Normal catalog work area 

1304 518 CCWX CCW definition 

1304 518 CCWCODE Write-to-console op code 

1305 519 CCWDTA Pointer to message buffer 

1308 51C : 

1310 SIE CCWCNT Length of message buffer 

1312 520 CCBX CCB definition 

1312 520 9 - 

1321 529 CCWPT Pointer to channel program (CCWX) 
1324 52C Unused 

* Multi-use field 


ypona=a = ha 


Oo @ 
=- Oo 
Le) 
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Offset 
Dec Hex 


1336 538 


1336 538 
1336 538 
1347 543 
1355 54B 
1401 579 
1404 57C 
1408 580 
1412 584 
1416 588 
1420 58C 
1424 590 
1428 590 
1432 598 
1436 59C 
1436 59C 
1452 SAC 
1456 5BO 
1460 5B4 
1460 5B4 
1476 5C4 
1480 5C8 
1484 5CC 
1564 61C 
1568 620 
1572 624 
1576 628 
1580 62C 
1604 644 
1606 646 
1608 648 
1610 64A 
1612 64C 
1614 64E 


Bytes and 


Bit Pattern Field Name 


apA HA HH HK DW 


24 
16 


- oworrhwAn b&b A 
Oo or 


* Multi-use field 


Figure 5.58 
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VMSG 


MSG 
MSGID 
MSGDSN 
MSGTXT 
OWSTRTGV 
OWAOAL 
UACBAD 
AIXACBAD 
BCACBAD 
UPACBAD 
USBAD 
OWAUCPT 
FLRGATTR 


* 


* 


FLRGATRA 
FLEXCPEX 
FLEXCEPL 
FLEXCEPA 
INTCPL 
RPLPAD 
PLHADDR 
AIXBUFAD 
AIXBUFLN 


MSGPARMS 


MSGFLGBT 
NRPL 
AIXBCLEN 
UPGRM 
UPGRCT 
AIXUPLEN 


Description 


Volume name is built and used as part of 
calling parameter when catalog is called 
to get the time stamp 


Volume time stamp built 
Message identification 
Data set name 
Message text 


Start of GETVIS 

Address of OAL section 
User's ACB address 

AIX cluster ACB address 
Base cluster ACB address 
ACB of upgrade member 
Pointer to USB 

Pointer for IKQLAB 

Copy of CTGFL for ‘RGATTR’ 


Length of ‘RGATTR’ data 
Pointer to ‘RGATTR’ 
Copy of exception exit CTGFL 


Length of exception exit data 
Address of EXCPEXIT 

Internal CPL 

RPL pool just handied 

Address of first PLH 

Upgrade buffer pool 

Length of upgrade buffer pool 
Parameter list for IKQOCMSG 
Message flag byte 

Number of user strings 

GETVIS length for ACB/RPL 
Number of members in upgrade set 
Upgrade set loop counter 

Length of upgrade set (RPL+PLH) 





Open Work Area (OPNWA) description and format (part 7 of 8) 
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5.118 


Offset 
Dec Hex 


1616 650 


1617 651 


1618 652 


1619 653 


1620 654 
1621 655 
1623 657 
1626 65A 
1629 65D 
1632 660 
1635 663 
1638 666 
1641 669 
1646 66E 
1648 670 
1648 670 
1648 670 
1648 670 
2160 870 


2164 874 
2168 878 


Bytes and 


Bit Pattern Fleld Name 


«XX XXXX 
4 


«XXX XXXX 


NaoddaQa0nanD — 


a 
_ 
nN 


* Multi-use field 


Figure 5.58 
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AIXFLG 


AIXUPGR 
AIXBASE 
AIXPE 
AIXPEU 
AIXPATH 
AIXMUS 
AIXEUO 
AIXUSERR 


AIXFLG2 


AIXTHB 
AIXPEUBF 


PATHFLG 
PFLUPD 


* 


RESETSW 
ESDSERR 
OALEFND 
JRNACT 
CATOPEN 
REPETSW 
VALCKSW 
WARECLUS 


SAVAIX 
AIXUSAV 
AIXYENTR 
AIXDNAM 
AIXINAM 
BCDNAM 
BCINAM 
CLUNAME 
INTWA 
LSRCNT 
OWA2 
OWAUCAT 
USCTGWA 


OWAMSGAR 


AUROOT 


CPAADR 
WAIKQSTM 


Description 


Alternate index flags 

Upgrade set available 

Base cluster handled 

Path entry handled 

Path entry of upgrade set 
Path structure open 

Member of upgrade set handled 
AIX as end-use object 
Upgrade set error 

Alternate index flags 2 

THB is for upgrade set 

One additional index buffer already 
present 

Reserved 

Path flags, first byte 

Update option 

Reserved 

Path flags, second byte 
Switch for reset of data set at open time 
ESDS error flag 

OAL entry found 

JRNAD active 

Catalog open in progress 
Switch for allocate 

Validity check switch 
Indicates a cluster refresh of catalog 
information is required 

Save area for AIXFLG 

Save area for ACB option 
Internal address of Y entry 
AIX data name 

AIX index name 

Base cluster data name 

Base cluster index name 
Cluster name save area 
Internal catalog work area 
Number of data sets with LSR 
Work area 

IKQCAT work area for UCAT 
Catalog work area IKQOPNUS 
Message work area 


Address of first control block in alloca- 
tion unit 


Address of channel program area 
Address of storage manager module 





Open Work Area (OPNWA) description and format (part 8 of 8) 
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Request Parameter List (RPL) 


The RPL contains user-request information and error feedback information. 
It also maintains information required by GET and PUT. The RPL is 
created by the user with the RPL macro instruction. 


Offset 


Dec Hex 


1E 
20 


Bytes 


2 


Field Name 


RPLID 
RPLIDD 


RPLSTYP 
RPLSDV1 
RPLSVSE1 


RPLLEN 
RPLRBA 
RPLDDOD | 
RPLARG 
RPLRCD 
RPLAREA 


RPLRLEN 
RPLBUFL 
RPLACB 
RPLDACB 
RPLSTRID 
RPLREQ 


RPLPOINT 
RPLGET 
RPLERASE 
RPLPUT 
RPLUPDTE 
RPLINSRT 
RPLCHECK 
RPLRCLSE 
RPLENDRQ 
RPLFRCIO 
RPLVERFY 
RPLPUTL 
RPLWRBFR 


RPLKEYL 
RPLOPTCD 


Description . 


Control block identifier = X‘OO' 
RPL equate 

Release indicator 

DOS/VS VSAM Release 1 
VSE/VSAM Release 1 
VTAM 

Length of RPL 

RBA of last record processed 
DD field 

Pointer to search argument 
Record description 
Address of the caller's work 
area 

Length of record 

User buffer size 

Address of the caller's ACB 
Catalog compatibility 

RPL string identifier 
Request type* 

POINT request 

GET request 

ERASE request 

PUT request 

Update request 

insert request 

Check request 

RCLOSE request 

ENDREQ request 

FORCIO request 

VERIFY request 

PUT locate request 

Write buffer request 

Key length 

Option codes 


This value may be altered internally by VSAM, for example, X‘24’ from applica- 


tion program is changed to X‘0C’ by IKQRQA 


Figure 5.59 


Licensed Material — Property of IBM 





Request Parameter List (RPL) description and format (part 1 of 4) 
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Offset 


Dec Hex 


35 


36 


37 
37 
37 


24 


25 


25 
25 


Bytes 


3 
1 
1 


Field Name 


RPLOPT1 


RPLKEY 
RPLADR 
RPLSEQ 
RPLDIR 

RPLASY 
RPLSKP 
RPLCNV 
RPLUPD 


RPLOPT2 
RPLKGE 


RPLGEN 
RPLNSP 


~ RPLNUP 


RPLLOC 
RPLUBF 
RPLBWD 
RPLLRD 


RPLHLD2 


RPLHLD 


RPLFLAG 
RPLECBPR 


RPLFOBK 
RPLFDB1 
RPLRTNCD 


Error class codes (stored from Register 15) 


39 
39 
|| 39 
39 


27 
27 
27 
27 


RPLNOERR 
RPLNORPL 
RPLLOGER 
RPLPHYER 
RPLVABND 
RPLFDB2 
RPLFTNCD 
RPLFUPG 
RPLFAIX 
RPLFINC 
RPLFDB3 
RPLERRCD 
RPLERCD 


RPLFDBKC 


Description 


First byte of options 


Keyed access 
Addressed access 
Sequential 

Direct processing 
Asynchronous 

Skip sequential access 
CNV access (RBA) 
Update 


Second byte of options 
Search key greater than or 
equal 

Generic key request 

Note string position 


’ No update 


Locate mode 

‘User buffers 

Backward processing 

Last record processing 
Second test and set byte (RPL 
not available) 

RPL available 

Test and set byte (RPL held - 
request not completed) 
Request completed 

Flag byte 

CMS ECB indicator 


Error feedback area 
Error class (return) code 
Error class code 


No error detected 

RPL heid by another request 
Logical error 

Physical error 

TP I/O prohibited 


Function type code 


Function type code 
Upgrade processing 
AIX processing 
Upgrade set is incorrect 


Error type code 
Error type code 
Error type code 
Error type code 


The following equates are for the various feedback returns that may be set for offset 39 (27). 
They fall into the three categories shown. 


Returns that are not errors (Register 15 = X‘00’) 
RPLEOV X'04' 
RPLOPKEY X'08' 
RPLNEWCA — X‘10' 
RPLCIWNG X‘1C’ 


EOV called during request 
Duplicate key (in AIX record) 
Index full - CA split required. 
Possible duplicate records in 
this Cl (address processing of 
KSDS). 





Figure 5,59 Request Parameter List (RPL) description and format (part 2 of 4) 


5.120 | VSE/VSAM VSAM Logic, Volume | Licensed Material — Property of IBM 


Offset Hex. 
Dec Hex Bytes Field Name Digit Description 


Logical errors (register. 15 = X‘08’) 


Figure 5,59 
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RPLEOFDS 
RPLEODER 
RPLDUPRC 
RPLDUP 
RPLSEQCK 
RPLNRFND 
RPLNOREC 
RPLEXCTL 


RPLNVOLM 
RPLNRSPA 
RPLNOEXT 
RPLSPACE 
RPLINRBA 
RPLNKEYR 
RPLNOVIR 
RPLWRKAS 


RPLCDLOD 
RPLVLERR 
RPLNOPLH 
RPLNOPEN 


RPLKEYES 
RPLADRKS 
RPLINERS 
RPLINLOC 


RPLNOPOS 
RPLNGUPD 
RPLUPDKC 
RPLLENCN 


RPLCONOP 


RPLIMRCL 
RPLIMGKL 


RPLINLD 


RPLCATLG 
RPLSRLOC 
RPLSRADR 


RPLINCSR 
RPLNOBAS 
RPLMAXPT 
RPLNOBUF 
RPLINCNV 


RPLINVRR 
RPLRRADR 


RPLIPATH 
RPLINBWD 


End of data set encountered 
End of data set encountered 
Duplicate record 

Duplicate record 

Sequence error 

No record found 

No record found 

Data already in exclusive 
control 

Volume or extent unavailable 
No DASD space available 

No DASD space available 

No DASD space available 
Invalid RBA specified 

No key range for new record 
Insufficient virtual storage 
User's work area not large 
enough 

CDLOAD failure 

Internal VSAM logic error 

PLH in use (no string available) 
Access type not requested at 
Open 

Keyed request for ESDS 

ADR or CNV insert for KSDS 
IIlegal ERASE request 

Illegal locate mode specifica- 
tion 

Positioning error 

No valid GET UPD issued 

Key change during update 
Length change for addressed 
update 

Improper or conflicting RPL 
options 

Improper RECLEN specified 
improper generic key length 
specified 
lilegal request during data set 
load , 
Internal catalog call failure 
lIlegal locate mode 

illegal request for spanned 
record 

Inconsistent spanned record 
No base record 

Maximum of pointers exceeded 
No buffers available (LSR only) 
Invalid Cl, possibly duplicate 
data addressed using address 
mode for update. 

Invalid relative record number 
illegal address requested 
(RRDS) 

lilegal path access 

Illegal backward mode request- 
ed 
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Offset Hex. 
Dec Hex Bytes Field Name Digit Description 


Physical errors (register 15 = X‘0C’) 
RPLRDERD Data read error 
RPLRDERI ‘08’ index read error 
RPLRDERS ‘OC’ Sequence set read error 
RPLWTERD ‘10’ Data write error 
RPLWTERI : Index write error 
RPLWTERS Sequence set write error 


RPLCHAIN Pointer to next RPL 
RPLAIXID AIX information byte 


RPLAXPKP ‘O1' Prime key pointers are used 
(base cluster is a KSDS) 


Reserved 


RPLAIXPC Number of base cluster 
pointers in the AIX record 


RPLXID Transaction ID 
Reserved 
RPLEND End of RPL 





Figure 5.59 Request Parameter List (RPL) description and format (part 4 of 4) 


VSAM Shared Resource Table (VSRT) 


The VSAM Shared Resource Tabie contains the addresses of the resource 
part of the resource pool (PLH pool, buffer pool, the RSCB, and CPA pool), 
together with the addresses of various control blocks built during processing 
of the BLDVRP macro. 


The VSRT is contained in the phase IKQVRT and is loaded by means of 
CDLOAD when required. 


Offset Hex. 
Dec Hex Bytes Field Name Digit Description 


VSRTBKID X'15' Control block identifier 
Reserved 

VSRTLEN Length of VSRT 

VSRTID Control block name 'VSRT’ 
Reserved 

VSRTFLG1 Fiag byte 1 


LSR ‘A0' LSR pool indicator 
VSRTFLG2 Flag byte 2 


VSRTUNCT Number of data sets opened 
with the LSR option 


VSRTECB ECB for the VSRT 


VSRTCOM Communication byte 
VSRTWAIT ‘80’ Wait flag 


VSRTGATE Exclusive control gate: 
X‘00' = ECB is free 
X'FF’ = ECB is in use 





Figure 5.60 VSAM Shared Resource Table (VSRT) description and format 
(part 1 of 2) 
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Offset 





Dec Hex Field Name Description 

VSRTRP Address of the contro! block 
part of the resource section of 
the VRP 

VSRTRLEN Length of the control block part 

VSRTPLHA Address of the PLH pool in the 
resource section 

VSRTSTRN Total number of PLHs required 
for all data sets sharing the re- 
source pool 

VSRTKL Maximum key length of the 
data sets sharing the resource 
pool 

VSRTPLHL Length of each PLH in the PLH 
pool 

VSTRSCB Address of the RSCB 

VSRTBUFH Address of buffer pool 

VSRT1STB Address of first buffer 

VSRTMBSZ Maximum buffer size in buffer 
pool 

VSRTSPNO Number of subpools in buffer 
pool 

VSRTBFNO Number of buffers in buffer 
pool 

VSRTBFLN Length of the buffer part of the 
resource section 

VSRTCPAH Address of the channel pro- 
gram area pool in the resource 
section 

VSRTCPAL Length of the channel program 
area pool 

VSRTTHBA Address of the THB pool 

VSRTTHBL Length of the THB pool 

Figure 5.60 VSAM Shared Resource Table (VSRT) description and format 
(part 2 of 2) 
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Section 6. Diagnostic Aids 


This chapter provides several aids that can be useful when trying to diag- 
nose difficulties with VSAM modules. These aids include: 


Additional Aids 


A list of VSAM lock resource names (Figure 6.1) and their associated 
use by VSAM. 


A chart (Figure 6.2) showing the lock option/control for locking various 
types of files. 

A list of macro instructions (Figure 6.3) issued by VSAM users, modules 
or other macros and their use. 

Cross reference tables (Figures 6.4 and 6.5) showing the VSAM modules 
and the macros they issue. 

A description of the Catalog Communication Area, Register Save Area 
and a list of error codes (Figure 6.6), set in the CCA by catalog mange- 
ment modules, together with the reason codes belonging to each error 
code. 

A list of return codes (Figure 6.7) set in register 15 which indicate 
DADSM conditions when processing is completed. 

A list of error codes (Figure 6.8) showing control block manipulation 
modules and the error code(s) they issue. 


A list of error codes (Figure 6.9) which may be issued by OPEN mo- 
dules. 


A list of error codes (Figure 6.10) which may be issued by CLOSE and 
TCLOSE modules. 


A list of error codes (Figure 6.11) which may be issued by the SHOW- 
CAT module. 


A list of error codes (Figure 6.12) which may be issued by the BLDVRP 
and DLVRP modules. 


A list of calling procedures and calling sequence for catalog manage- 
ment procedures (Figure 6.13). 


A description of service aid phases and how to use them. 


Further aids can be found in other parts of the book and in the program 
listings. These include: 


Register contents on entry to a module, which are under Jnput in the 
module prologues. 


Use of registers and equated names for registers, which can be found 
under Notes in the module prologues. 


Error codes, which are under Exit-Error in the module prologues. 


A list, which is in the Directory, of modules, their component, their entry 
points, and their associated method of operation and program structure 
diagrams. 


A cross-reference list, which is in the Directory, of catalog external entry 
points and their associated modules. 
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| VSAM Use of Locks 


Figure 6.1 is a list of the lock resource names used by VSAM and their 


associated functions. 


Resource Name 


V.addr.CAX.X‘0000' 


V.OAL.X‘0000000000000000' 


V.SYSMCO.X‘'0000000000' 
V.SYSOPEN.X‘'00000000 


V.volser.ci#.X‘'0000'! 


V.volser.ci#.X‘O0001' 


V.volser.ci#.X‘0002' 


V.volser.ci#.X‘'0003' 


V.volser.ci#.X‘'0004' 


V.volser.ci#.X‘O0005' 


V.volser.X'0000000008' 


V.volser.ci#.X‘nnnn’ 


V.volser. UPL. X‘'0000' 


Function 


Serialize access on the C/M CAXWA chain 
during delete, update, or search operations on 
the chain. 


Maintains integrity of OAL by serializing access 
through OPEN/CLOSE. 


Serialize master catalog define and open. 


Serialize OPEN, CLOSE, DELETE, and DEFINE 
access to the catalog (e.g. OPEN indicator) and 
synchronize the catalog with share options 
locks. 


File lock - Used to enforce SHAREOPTIONS 
protection for components of a file. The name 
volser.ci# uniquely identifies a component being 
protected. The volser is the serial number of the 
volume containing the catalog describing the 
component and ci# is the number of the control 
interval in the catalog where the component is 
being described. 


Outcount lock - Maintains a count of output 
users of the file denoted by volser.ci#. This lock 
is maintained for SHAREOPTIONS(3) and 
SHAREOPTIONS(4) files. 


Keyed access lock - Represents keyed access 
for output to a SHAREOPTIONS(4) file. It is used 
together with the address access lock to prevent 
concurrent keyed access and address access 
for output to a SHAREOPTIONS(4) file. 


Address access lock - Represents address or 
CNV access for output to a SHAREOPTIONS(4) 
file. 


Used by Record Management to serialize use of 
the Upgrade Set Block (USB) when the ACB has 
been opened with multiple strings. 


Used by Record Management to serialize 
allocation of control areas within an extent of a 
SHAREOPTIONS(4) file. 


Volume mount serialization - Used to 
synchronize mount requests for a given volume. 


Used for Record Management basic 
SHAREOPTIONS(4) locks on control areas, 
where nnnn is the CA number (Cl number for 
index component) plus 1024. 


Serialize master and user catalog update and 
locate functions. 


(Note: The period (.) as used in this list of lock resource names, represents 
concatenation only and is not part of the lock resource name.) 


1 The file lock is maintained by open/close using OWNER=PARTITION so that an ACB 
may be closed by a different task than the opening task. Figure 6.2 shows which lock 
option/control is used for locking various types of files. 





Figure 6.1 VSAM Use of Locks 
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File being 
opened File defined share option 
for: 


INPUT 


LOCKOPTION =1 LOCKOPTION =2 LOCKOPTION=3 LOCKOPTION=4 
CONTROL=SHARED CONTROL=SHARED CONTROL =SHARED CONTROL = SHARED 


OUTPUT LOCKOPTION=1 LOCKOPTION=2 LOCKOPTION=3 LOCKOPTION=4 
CONTROL=EXCLUSIVE | CONTROL=EXCLUSIVE | CONTROL=EXCLUSIVE | CONTROL=EXCLUSIVE 





Figure 6.2 Lock option/control for locking various types of files 
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Macro-to-Module Relationships 


Figure 6.3 contains the macro instructions issued by VSAM users, modules, 
or other macros. Their types are identified as follows: 


G 
SA 
M 


ACB 
ASYSCOM 
AVRLIST 
CANCEL 
CATLG 


CCB 
CDLOAD 
CLOSE 


COMRG 
CVTOC 
DCTENTRY 
DEQB 
DTFCN 
ENDREQ 


ENQB 
EOJ 
ERASE 
EXCP 
EXLST 
EXTRACT 
FREEVIS 
GENCB 
GENDTL 


GET 
GETFLD 
GETVCE 
GETVIS 
IDCDF60 


IGGCAXWA 
IGGCCA 


Figure 6.3 
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generating macro 
VSE action macro 
mapping macro 


internal (called by another macro) 


VSAM action macro 


copy source book macro 


Generate an ACB 

Get address of systems communications region 
With DCTENTRY, map device characteristics 
Cancel a task 


Load address of catalog parameter list (CTGPL) 
into R1 and invoke catalog management 


Build a CCB 
Load module(s) 


Disconnect a user's program from a VSAM data 
set 


Get communication region address 

CVH close VTOC 

With AVRLIST, map device characteristics 
Free B-transient 

SYSLOG DTF 


Free a PLH and terminate processing on 
associated string 


Hold B-transient 

End of job 

Delete a record 

Execute channel program 

Generate EXLST 

Get control block information from supervisor 
Free virtual storage 

Generate a control block 


Generate a DTL block to be used as an interface 
to LOCK/UNLOCK 


Retrieve a record 

Get specified field value 
Get device characteristics 
Get virtual storage 


Map Access Method Services catalog communi- 
cation table (ACC), catalog Cl number to CRA Cl 
number translation table (CTT), and volume 
timestamp table (VTT). 

Map catalog auxiliary work area (CAXWA) 


Map catalog communications area (CCA) 
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Macro 


IG@GMCDCL 


IGGMCMDM 
IGGMCMWA 


IGGMCTRC 
IGGMDLWA 
IGGMDRWA 


IG@GMDVCH 
IGGMEND 
IGGMFONM 


IGGMGVO 
IGGMNAME 


IGGMODUL 
IGGMPROC 


IGGMSAWA 


IGGMUPDE 


IGGMVEDC 
lIPAMDTF 
IIPDTF 
IIPPRAT 
\JBLBRC 
IJJHCPL 
\JJHDLST 
\JJHFMT1 
\JJHFMT3 
\JJHFMT4 
IKQACB 
IKQACBG 
IKQACB1 
IKQAIR 
IKQAMBL 
IKQAMCBS 
IKQAMDSB 
IKQARDB 
IKQAREX 
IKQARGH 
IKQASGN 
IKQBHD 
IKQBKPHD 
IKQBLARD 
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Use 


Issue the following macros to define the com- 
monly used declarations for VSAM catalog man- 
agement modules: IGGCAXWA, IGGCCA, 
IGGMCTRC, IKQACB, IKQAMCBS, IKQCOMRG, 
IKQCTGEL, IKQCTGFV, IKQCTGPL, IKQVRGN 


Map the VSAM catalog management commonly 
used record structures 


Map the VSAM catalog management services 
work area 


Map catalog return codes 
Delete work area layout 


Map the VSAM catalog VTOC label read-in work 
area 


Map VSAM catalog management device charac- 
teristics , 


Generate exit code at the end of catalog 
management modules 


VSAM catalog dictionary information for external 
field names 


Map the volume information group occurrence 


Generate catalog module name for error and 
reason codes 


Generate header code for catalog modules 


Generate header code for catalog internal 
procedures 


Map the VSAM catalog management suballocate 
work area 


Issue IGGMVEDC, IGGMCDCL, IGGMCMDN, 
IKQAMDSB, and IGGMSAWA to define the com- 
monly used declarations for VSAM catalog man- 
agement Update-Extend modules 


Map the volume catalog record 
Generate/map AMDTF table 
Generate/map DTF table 
Generate/map address list 

Map label area record 

Map CVH Parameter List 

Map CVH Volume Descriptor List 
Map format-1 VTOC label 

Map format-3 VTOC label 

Map format-4 VTOC label 

Map ACB 

Generate ACB (called by IKQACB1) 
Generate ACB (called by ACB) 
Map alternate index record 

Map AMBL 

Map AMCBS 

Map AMDSB 

Map ARDB 

Map EXLST argument entry 

Map argument header 

Invoke automatic assign function 
Map buffer header 

Map header for CCW area 

Build an ARDB 
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Macro 


IKQBUFE 
IKQCBMTB 


IKQCB1 


IKQCB2 


IKQCCB 
IKQCCBCW 
IKQCCW 
IKQCGETC 
IKQCIW 
IKQCLCOR 
IKQCLNUP 
IKQCLRLS 
IKQCLWA 
IKQCOMB 


IKQCOMRG 
IKQCTGFL 
IKQCTGFV 
IKQCTGPL 
IKQCWS 
IKQDDR 
IKQDEVT 


IKQECB 
iIKQEDB 
IKQEDBLD 
IKQEQU 
IKQERC 
IKQERMAC 


IKQEXLG 
IKQEXL1 
IKQEXLST 
IKQEXP 
IKQFCDB 
IKQFNDLB 
IKQFXL 
IKQGCB 
IKQDTL 
IKQIOARG 
IKQIODRB 
IKQIORQU 
IKQIOWKA 
IKQIXHDR 
IKQJIB 
IKQJRNDS 
IKQKWTB 
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Map BCB 


Define table of constants for control block 
generation modules 


Transform operands for control block manipula- 
tion macro instructions GENCB, TESTCB, 
MODCB, SHOWCEB, IKQCB2, and IKQERMAC 


Scan keywords and generate code for control 
block manipulation macro instructions GENCB, 
TESTCB, MODCB, SHOWCEB, IKQCB1, and 
IKQERMAC 


Map IORB 

Map IORB 

Map CCW 

Obtain storage in which to copy old ARDB 
Map control interval split work area 

Get address of space in which to build EDB(s) 
Disconnect ACB and AMBL 

Free storage obtained by Open and/or EOV 
Close work area 


Generate a combination name entry for the 
VSAM catalog dictionary 


Map communication region 

Map field parameter list (CTGFL) 

Map catalog field vector table (CTGFV) 
Map catalog parameter list (CTGPL) 
Map CCW skeletons 

Map duplicate data recovery Work Area 


Read label area and/or determine the device 
type for the file-ID (IKQDEVT uses CDLOAD) 


Map Event Control Block 
Map EDB 

Build EDB 

Map register equates 
Internal error codes equate 


Issue M-notes (assembler macro error mes- 
sages) for control block manipulation macro in- 
structions GENCB, TESTCB, MODCB, 
SHOWCEB, IKQCB1, and IKQCB2 


Generate EXLST (called by IKQEXL1) 
Generate EXLST (called by EXLST) 

Map EXLST 

Description of EXPAD parameter list 

Map CCW blocks in CCW pool 

Find LUB (logical unit block) for symbolic unit 
Map Fix List (used with lIORB) 

Generate a control block (called by GENCB) 
Generate a DTL for use by the Lock manager 
Map DASD address 

Map I/O driver block 

Map register equates 

Map I/O work area in PLH 

Map index record header 

Map JIB (job information block) 

Parameter list for journalling 


Define table of constants for control block 
manipulation modules 
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IKQLOCK 


IKQLPMB 
IKQLUB 
IKQMCB 
IKQMDADS 


IKQMSGPL 
IKQOAL 
IKQOCFSP 
IKQOCGSP 
IKQOCPRC 
IKQPARM 
IKQOPCLR 
IKQOPCLW 
IKQOPLCT 
IKQOPNWA 
IKQPLH 
IKQPUB 
IKQRDF 
IKQRPL 
IKQRPLG 
IKQRPL1 
IKQRQM 
IKQSCB 
IKQSHRW 
IKQTCB 
IKQTHB 
IKQUNLK 


IKQUSB 
IKQVLST 


IKQVOL1 
IKQVRGN 
IKQVRPPL 


IKQVSMDP 
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Lock a system resource or file by means of the 
LOCK macro 


Map LPMB 
Map Logical Unit Block 
Modify a control block (called by MODCB) 


Map DADSM parameter list (interface block to 
DADSM) 


OPEN/CLOSE message primary list 
Open ACB list 

Free space for DSA 

Get space for DSA 

Connect dynamic storage area 

Map Buffer Manager Parameter List 
Register equates 

Map of common section of work area 
Map fields located by catalog 

Map Open work area 

Map PLH 

Map physical unit block 

Map RDF and CIDF fields 

Map RPL 

Generate RPL (called by IKQRPL1) 
Generate RPL (called by RPL) 

Generate modules IKQRQA and IKQRQB 
Display a control block (called by SHOWCB) 
Map SHRW (File Sharing Work Area) 
Test a control block (called by TESTCB) 
Map THB 


Unlock a system resource or file by means of the 
UNLOCK macro 


Upgrade set block 


Map list of volume unit, symbolic unit, and 
volume time stamp 


Map volume-1 label 
Map anchor table 


Map parameter list for BLDVRP function 
(IKQBRP) 


Map VSAM dump 
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Macro 


LABEL 
LOAD 
LOCK 
LPLDCT 
MAPBDY 
MAPCOMR 
MAPPIB 
MODCB 
MODDTL 
MODFLD 
OPEN 
OVTOC 
POINT 
POST 
PUT 
PVTOC 
RPL 
SHOWCB 
SYSCOM 
TCLOSE 
TESTCB 
UNLOCK 
VERIFY 


WAIT 


Figure 6.3 


VSE/VSAM VSAM Logic, Volume 1 


110 


Interface macro to call symbolic label access 
Load a phase 

Lock a system resource 

Map of label parameter list 

Map for partition boundries 

Map partition COMREG layout 

Map program information block 

Modify a control block 

Modify a DTL 

Modify specified field value 

Connect a user’s program to a VSAM data set 
CVH open VTOC 

Position VSAM at a record 

Post an ECB 

Store a new or updated record 

CVH process VTOC 

Generate an RPL 

Display a control block 

Map system communication region layout 
Purge buffer and update catalog (no disconnect) 
Test a control block 

Unlock a system resource 


Build calling sequence for VSAM function 
VERIFY 


Wait on a CCB or IORB for 1/0 to complete 
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Catalog Communication Area Register Save Area 
A catalog communication area (CCA) is built for every call to catalog 
management. The CCA contains a register save area (CCAREGS) that 
allows the PSR (programming systems representative) to follow the flow of 
control from one catalog management procedure to another, through each 
procedure called to process the request. 


The contents of the first three words in the CCA field named CCAREGS 
are as follows: 


e the first word contains the contents of register 13, which is a pointer to 
the user’s save area, and 


e the second and third words are unused. 


If a catalog management procedure is entered from another catalog manage- 
ment procedure, the fourth and subsequent words are used as three-word 
catalog save areas defined as follows: 


e the first word contains the contents of register 12, which is the calling 
procedure’s base address, 


e the second word contains the contents of register 13, which is a pointer 
to the previous 12-byte entry in the register save area (CCAREGS), and 


¢ the third word contains the contents of register 14, which is the return 
address (in the calling procedure). 


Immediately after registers 12, 13, and 14 are saved (at register 13 + 12), 
register 12 is updated to contain the called procedure’s base address. Regis- 
ter 13’s value is increased by 12, so that it points to the latest entry in 
CCAREGS. While a catalog management procedure is processing, register 
11 contains a pointer to the beginning of the CCA. 


Note that backward movement is not recorded in the trace table. For 
example, if procedure B returns to procedure A, the return is not shown in 
the register save area. 


Catalog Management Error Code-to-Module Relationship 
The error codes issued by VSAM catalog modules are set in the CCACD1 
field of the CCA and transferred to register 15 on exit from catalog manag- 
ment. The reason codes are set in the CCAREASN field of the CCA. They 
are passed back to the user via AMS or Record Management. 


Figure 6.6 contains the definitions of the error codes. To each error code 
belong one or several reason codes. Along with the reason code the module 
which detected the error is also shown. It is identified by the last two letters 
of its name. The PL/S names are those names to which the catalog manage- 
ment error codes are equated. To find the assembler instructions which set 
the error code, first reference the PL/S statement, then relate the PL/S 
statement to the appropriate assembler language statement. 
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Reason 
[bec | Hex | Codes 


PL/S Name for 
Code 











Module Name Description 


AC, AD, AE, Error when opening a catalog. 
AH 


AE, CS 
AH 


















Error when closing a catalog. 





Internal error - an ACB was supplied to catalog management 
but its ID was not X‘AO’. An IDUMP was issued. 


Can also be caused by a problem program overlaying storage it 
does not own. 


The user catalog entry in the master catalog cannot be found. 
The user has either made a spelling error, has exported the 
user catalog, or has more than one master catalog and has 
executed IPL using the wrong one. 

















During catalog DELETE, the cluster record for the catalog can- 
not be found at its normal location (3rd self-describing record). 
An IDUMP was issued. 





The catalog I/O routine read a record from the catalog and 
found it to be a free record. Since this never occurs during 

normal processing, an internal error is returned. An IDUMP was 
issued. 






CG, AN, BG, 
BN 


AL, AT, BD, 
CA, CG 


CB 








A request to read a record resulted in a no record found error 
from VSAM. 













A request to place a record by key into a catalog resulted in a 
duplicate key error from VSAM. 





An internal error has occurred indicating that a record thought 
to be on the buffer chain is not present. An IDUMP was issued. 



















RCNOTCYL The Access Mehtod Services CYLINDERS parameter was used, 


but the extents found on the corresponding DLBL and EXTENT 
statements do not start or end on a cylinder boundary. This 
error can only occur during DEFINE CATALOG, DEFINE 
SPACE, or DEFINE UNIQUE. 





RCINSP Insufficent direct access space available to extend the catalog 


or CRA. (Reason codes are from Record Management - see 
Volume 2.) 


To correct this situation, a DEFINE SPACE is needed to provide 
more space for suballocation. 


1/O error during a LOCATE. 
1/O error during a CATALOG VERIFY operation. 
1/O error but not during LOCATE processing. 












RCIOL 
cg 
AG 
AG, CG, EG 
BC 












RCIONL 










1/O error during EXCP during catalog open (non-build case). 








RCINCPL Internal error indicating that catalog management was unable to 


return the requested data in the catalog parameter list (CPL) for 
update extend. An IDUMP was issued. 










RCDSNF Incorrect record type read. 
Data set not found in the VTOC. 


Internal workarea provided was too small. 










RCVLSZ 










RCVLSM It has been detected during DELETE CATALOG that the 


CTGWKA work area is too small. The user (Access Method 
Services) has to provide a larger area. 


Figure 6.6 Catalog Management error code-to-module relationship (Part 1 of 10) 
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PL/S Name for ex | codes 


RCINFUNC 48 30 An invalid CPL has been passed to the catalog management 
driver. An IDUMP was issued. 














ET During DEFINE, an incorrect master catalog ACB was found. 


An IDUMP was issued. 


Alter of nonVSAM data sets or NOCIFORMAT with ERASE is 
not allowed. 










BD 


BD 
BL, CL 
A7 


A7, BD, BN, 
A6, AF, AQ, 
CL, FD 


BM 


Alter of catalog name is not allowed. 





Forced delete space is not allowed on catalog volume. 
ERASE was specified for DELETE of a NO-CI format ESDS. 


1/O error during VTOC processing. (Reason codes from 
DADSM - see Figure 6.6.) 





































All attempts to provide a password via the system operator are 
used without a successful compare. 





BM No prompt allowed and password not provided, or incorrect 


password provided via the catalog parameter list. 





BM USVR requested stop. 


Security violation from DADSM scratch. 





RCINENT 





BG An attempt was made to delete a catalog without specifying an 


entry type. 





Invalid entry type ‘C’ or nonVSAM. 
Invalid entry type ‘C’ for alter of attributes. 
Invalid ‘C’ or ‘I’ entry type for alter buffer size. 
‘C’ record invalid for alter of AMDSB. 


No alter volume allowed on ‘C’'-type records. 





Test CPL error during ADD volume. An IDUMP was issued. 
AIX G record association is not 'D’|'I'|'C’ (AIX is not a KSDS). 
Upgrade set Y record association is not Dil. 


‘Y’ association in base cluster data record does not point to a 
‘Y' record. 


‘D’ association in ‘C’ record does not point to a ‘D' record. 
Upgrade or update for a record which is not a ‘G’ or ‘R’. 
Alter of exception exit but the record is not ‘D' or ‘I’. 
Alter of average record size but the record is not 'D’ or ‘I’. 


Alter of expiration date but the record is not ‘C,’ ‘G,' ‘R,’ ‘M,’ 
or ‘U,' 
DEFINE, DELETE, ALTER of nonVSAM entry prohibited in re- 
coverable catalog. 


ALTER REMOVE VOLUMES is not allowed for a noallocate data 
set if the volume contains a CRA, or if the resulting volume list 
is null. 









Alter of share options but the data set is open. 


Figure 6.6 Catalog Management error code-to-module relationship (Part 2 of 10) 
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PL/S Name for Reason 





Module Name Description 


Code | Hex | Codes 
RCNAME Test field name not present in group space header. 

4 Association names do not exist. 

6 Error on retrieval of fixed block device characteristics for ‘D’ or 
‘) component during LOCATE of an F-field name. LOCATE 
issued a O return code, but failed to return request information. 
A system error. 

RCNOSP 2 Cannot extend a unique file. 

4 No secondary extent value specified. 

6 Not enough class-O space available for suballocation (extend 
function). 

12 More than 16 extents/volume for reusable file. 

16 On a data space allocation for a DEFINE SPACE command, 
rounding of extent(s) specified in the EXTENT statement(s) 
resulted in no data space being allocated. 

16 On a DEFINE with the UNIQUE attribute, rounding of the first 
extent specified in the JCL resulted in no data space being 
allocated. 

18 On a data space allocation for a DEFINE catalog, rounding of 
the space specified in the first (or only) EXTENT statement 
resulted in no space being allocated. The first extent must be 
large enough to contain the catalog. 

24 Not enough space of the required class (nonzero) is available 
on any eligible volume to suballocate space for an existing file 
(extend function). 

RCVOLFUL 2 On a DEFINE SPACE or DEFINE MASTER CATALOG using the 
. DEDICATE parameter, the volume was found to be full. 

4 On a DEFINE SPACE or DEFINE CATALOG using the ORIGIN 
parameter, the volume was found to have space allocated within 
the limits of the requested area. 

RCNMNTD 2 FB All mounted volumes for the default model have been tried for 
suballocation and failed. 

4 A6, A7, BL, No symbolic unit available, automatic assignment failed. 

CG 
8 A6, A7, BL, Volume not mounted; invalid or unassigned symbolic unit. 


CG, CO, AH 


12 A6, A7, BL, Volume not mounted, job canceled. 
CG 


16 A6, A7, BL, The operator replied ‘‘NEWPAC’’ but the volume was not 
CG, CO, AH_ | mounted. 


20 A6, A7, AH, Automatic unassignment unsuccessful. 
BL, CG, CO 


24 A6, A7, AH, During dynamic assignment, the lock table is full. 
BL, CG, CO, 
ET, FD, FQ 


28 A6, A7, AH, Insufficient storage available for dynamic assignment or unas- 
BL, CG, CO, | signment. 
ET, FD, FQ 
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PL/S Name for Reason 
Code !pec| Hex | Codes Module Name Description 
2 FE 


RCMAXEXT For a DEFINE SPACE or DEFINE CATALOG with the DEDICATE 
parameter, the maximum of 16 extents was reached before the 
volume was completely dedicated. 


RCRELOP Related object is reusable. 
Related object is an RRDS. 
Related object does not exist. 
AIX/PATH not allowed to be built over a catalog. 
Name of AIX/PATH and related object are identical. 
No pointer to a related object of an AIX/PATH. 


AIX not being built over a base cluster, or related path object 
not a cluster or an AIX. 


AIX/PATH not allowed to be built over a SAM ESDS. 
RCDATE Expiration date not reached. 
RCCRAOP Open of CRA failed. 

1/O error in CRA. 


Internal call to CO for CRA open has conflicting parameters. An 
IDUMP was issued. 


Space of less than one cylinder for CRA is not allowed. 
RCDSEXT 0 ’ | Attempt was made to exceed the maximum number of extents. 


RCSPANCK 0 Prime key as specified for spanned record is not completely 
contained in the first control interval of the record. 


Maximum logical record size for spanned records exceeds CA 
size. 


AIX key for spanned records is not completely contained within 
the first control interval of the base cluster record. 


One of the following: The AIX key is not completely contained 
within the base cluster record, or the maximum record size for 
defining an alternate index is too small. 


RCRECVOL Attempt was made to define a unique file on a volume owned 
by a recoverable catalog. You must define space before any 
unique files can be defined. 


RCCATEX The master catalog is already open, but a request has been 
made for master catalog DEFINE. 


RCINFNAM invalid field name. An IDUMP was issued. 
RCINFPL 2 Invalid group code in FPL. An IDUMP was issued. 


A fixed block catalog dictionary field name has been used with 
UPDATE or MODIFY. Fixed block field names are valid only 
with LOCATE and only with non-test FPLs. An IDUMP was 
issued. 


RCCATBAL Catalog out of balance (not used by VSE). 
RCSYSFLD Non-existent field being modified. An IDUMP was issued. 





Figure 6.6 Catalog Management error code-to-module relationship (Part 4 of 10) 
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PL/S Name for 
Code 










Module Name Description 


Invalid RBA return code from record management. 


ae 
| Hex | Codes 
24 


RCINCI 1 


Catalog build open processing, but specified Cl was greater 
than 9. 


CCR record (‘L’) read by error. 
Validity check on user block (not used by DOS/VSE). 


No pointer to VOLSER list and the appropriate default model 
was not found. 


No pointer to VOLSER list. 
No FPL to AMDSB of data. 


No FVT from cluster level. 






















RCBLKVCK 
RCINPTR 





No pointer in FPL to data set attribute. 
No FPL for volume space parameters. 
No pointer to expiration date value. 
No pointer to creation date in FPL. 
No pointer to device type in FPL. 
No FPL in FVT. 
No pointer to the workarea. 


No pointer to password data of related object. 














No pointer to owner ID in FPL. 
No pointer to cluster space parameter in FPL. 
No pointer to data space parameter in FPL. 
No pointer to index space parameter in FPL. 
No buffersize FPL in data FVT. 
No buffersize FPL in cluster FVT. 
No buffersize FPL in index FVT. 





No logical record size FPL in cluster or data FVT. 


No pointer to data set file sequence number in volume list FPL. 


Figure 6.6 Catalog Management error code-to-module relationship (Part 5 of 10) 
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PL/S Name for Reason 
Code | Hex | Codes Module Name Description 


RCMISPAR No length for volume serial list area. 
Missing DNAME parameter with DEFINE UNIQUE FILE. 
Missing cluster entry name. 
Missing space parameter in space FVT. 
Missing VOLSER list pointer in space FVT. 
Missing DNAME pointer in space FVT. 
No length in volume list from cluster FVT. 
No space parameter on ‘C’ or 'D' FVT. 
Average logical record size missing. 
No key specified. 
No entries in volume list. 
No entries in device type list. 
AIX name missing. 
Path entry name missing. 

RCINCNPM Index FVT found for RRDS or ESDS. An IDUMP was issued. 
Keyrange is invalid. 
Keyranges found on both data and cluster FVT. 
Workarea too small. 
Space parameters found on both cluster and data FVT. 
Buffersize specified more than once. 
Average logical record size specified on index FVT. 
Average logical record not valid for DEFINE CATALOG. 
Average logical record size specified on cluster and data FVT. 
Inconsistent keylength specified in ‘D' and ‘I’ FVT. 
Inconsistent VOLSER lists with different name in each list; or 
DLBL and volume list do not match. 


Primary aliocation for data space less than required for the 
catalog. 


Invalid space request type for catalog DEFINE. 


Unequal number of VOLSER and file sequence numbers in list 
entries. 


More device type entries than VOLSERs. 


Invalid key position specified on ‘D' or ‘I’. 





Invalid space request type on DEFINE. An IDUMP was issued. 


Figure 6.6 Catalog Management error code-to-module relationship (Part 6 of 10) 
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PL/S Name for | ees Reason 

Code Hex | Cod a6 Module Name Description 
AJ, ET The number of keyranges and the number of VOLSERs are not 
equal, or for a unique data component, the number of keyrang- 
es is greater than the number of VOLSERs. 














Unique attribute is not allowed for catalog DEFINE. 
RRDS has spanned attribute. 


RRDS has a maximum record length that is not equal to the 
average record length. 


An attempt was made to specify an exception exit for a data set 
which was originally defined with a DOS/VS Release earlier 
than Release 31. 





ET, EX, FB Access Method Services issued a DEFINE with tracks or cylin- 
ders as the allocation unit for a fixed block device. If Generate 
Volume List was used, the unit indicated CKD device but there 


were no CKD devices on the Default model. 















ET, EX, FB Access Method Services issued a DEFINE with blocks as the 
allocation unit for a CKD device. If Generate Volume List was 
used, the unit indicated FBA device but there were no FBA 


devices on the Default Model. 


An error was returned from the EXTRACT macro. An IDUMP 
was issued. 


RCINENTN 





AIX/PATH name is invalid; first character must be alphabetic. 
An IDUMP was issued. 


Unique name is invalid because it was Z999999, which is re- 
stricted. 








Data and index names not allowed for a catalog. An IDUMP 
was issued. 








A file-ID, greater than 27 characters was specified for a parti- 
tion independent or processor independent file. 





























RCVOLOWN 
RCONECAT 
RCNOSPSA 


Volume already owned by another catalog. 








Non-empty catalog cannot be deleted. 








Not enough class-O space available within the catalog for subal- 
location of a newly-defined file. 


On a DEFINE catalog command, a class-O data space was 
specified that was not large enough to allow suballocation of 
the catalog recovery area (CRA). There was sufficient space for 
the catalog. 


There is insufficient space of the required class (nonzero) in the 
specified volume(s) to satisfy a request for suballocation of a 
newly-defined cluster or alternate index. 


On a DEFINE catalog command, a nonzero class data space 
was specified that was not large enough to allow suballocation 
of the catalog recovery area (CRA). There was sufficent space 
for the catalog. 






RCVNDSPD Volume record not deleted from the catalog because some file 
still owns space on the volume. All empty data spaces on this 


volume have been deleted. 





RCINSSWA 














AB, AH, AQ, 
AT, BL, CB, 
CG, CO, CY, 
C9, EX, FA, 
FB, FC, FD, 
FQ 


Catalog management GETVIS error: A continuous area of main 
storage of the requested size is not available. 






CG Record management GETVIS error: As above, but the call came 


from record management. 
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PL/S Name for Reason 


Code rams Codes Module Name Description 


RCINVDTY 2 Device type not supported. 





Invalid device name. 


DEFINE NONVSAM has been specified for a fixed block device. 
Fixed block devices are not supported for NONVSAM. 


RCDUPNVL Duplicate name in VTOC. 
RCNSPVTC No space available in the VTOC. 


RCDSO The catalog is in use by some partition. Until the number of 
users is zero, the catalog cannot be deleted. 


The data or index component (or both) is (are) in use, and the 
file cannot be deleted. 


RCCATUNA No RPL available for processing, request ignored. An IDUMP 
was issued. 


Suballocate failure. 

No RPL available for processing, request ignored. 
RCMLRSZ 
RCMCISZD 
RCMCISZI 
RCKEYINC 
RCBUFSIZ 
RCSIZCAL 


Maximum logical record size exceeds allowable maximum. 
Cl size too large for allowable maximum for data component. 
Cl size too large for index. 

Key extends beyond the end of the maximum logical record. 


Bufferspace too small for minimum number of Cls. 


yn oO 98 0 0 O DO fF 


Not enough parameters specified in DEFINE. An IDUMP was 
issued. 


Specified and default values result in only one Cl per CA for a 
KSDS or alternate index. 


For a non-unique KSDS or alternate index, the index Cl size is 
too small, and an attempt to reduce the number of data Cls 
failed. 


For a unique KSDS or alternate index, the index Cl size is too 
small. The number of data Cls cannot be reduced because their 
size is fixed at one cylinder. 


Buffer space too small for a non-unique data set. 
Buffer space too small for a unique data set. 


The specified or default values result in less than one Cl per CA 
for an ESDS or RRDS. 


For a fixed block SAM ESDS, the SAM logical blocksize is not 
a multiple of the SAM logical record size. 


RCEXTOVL Overlap on: 
a. VTOC 
. Expired secure file 
. Expired file 
. Unexpired secure file 
. Unexpired file 
New extents 


RCINEXT Invalid EXTENT card. 


™oOoO QA 00 


Figure 6.6 Catalog Management error code-to-module relationship (Part 8 of 10) 
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PL/S Name for 
Code 


Module Name Description 


224 EO Maximum number of group occurrence pointers have been 
processed. 


RCMXGRP 











AW 
A7, AL, BL 


BM, BH, Cx, 
CG 


More than 125 AlXs in the upgrade set. 











RCLOCKER 
RCRCDLOF 


Time of day clock hardware error. 


CDLOAD error reason is: 
a. from CDLOAD 
b. 0 if no reason is available. 


IKQVLAB error (see Figure 6.7). 















































RCINDER AQ, AF, AH, 
AP, AE, A7, 
BX, BG, B8, 
BL, BN, CO, 
CS, FD 


AQ, A7, BL, 
B8, ET 


A8, BL, ET, 
FE 


AQ, ET 
ET 








No extents found. 













Invalid device type, invalid extents specified, or IKQVLAB error 
during device type processing. 





Too many extents, or duplicate volume serial numbers. 





Number of tracks required by the Access Method Services 
command exceeds DLBL total per volume. 





AH 
AH 
AH 


Catalog name in DLBL and CPL do not match. 





Master catalog DLBL not found. 





User or job catalog DLBL not found, or job catalog required but 
not found. 





AH 
AH 


DLBL catalog name is missing. 





Volume serial number in extent statement for job catalog does 
not match volume serial in the entry for this job catalog in 
master catalog. 


Automatic assign for CRA failed due to no programmer logical 
unit. 


Catalog recovery area OPEN failure because volume was not 
mounted. 


Automatic assign for user catalog failed due to no programmer 
logical units. 


User catalog OPEN failed because the catalog volume was not 
mounted. 











RCEFRMPH Physical |/O error occurred while trying to erase the data set 


being deleted. (Reason codes are from VSAM record manage- 
ment - see Volume 2.) 


This ACB could not be opened (OPEN failed while trying to 
erase). The address of the catalog ACB or the Cl number may 
be wrong. (Reason codes from OPEN - see Figure 6.7.) 


Figure 6.6 Catalog Management error code-to-module relationship (Part 9 of 10) 
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PL/S Name for ex | codes 


RCVOLENT 


RCEFRM 


Figure 6.6 


AB, AH, C9, 
CO, AC, CX 


AB, AH, C9, 


CO, AC, CX 


AB, AH, C9, 


CO, AC, CX 


AB, AH, C9, 


CO, AC, Cx 


AB, AH, C9, 


CO, AC, Cx 


AB, AH, C9, 


CO, AC, CX 


AB, AH, C9, 


CO, AC, CX 


AB, AH, C9, 


CO, AC, CX 


AB, AH, C9, 


CO, AC, CX 


AB, AH, C9, 


CO, AC, Cx 


AR, AT, BX, 
BN, AK 


A7 


Licensed Material — Property of IBM 


Successful request. 

Resource is not available. 

Lock table space exhausted. 
Inconsistent request. 

A deadlock would have occurred. 

DTL format error. 

Resource is already exclusively owned. 


Lock file space exhausted. 


VOLID PARM used but the volume is not online. 


Irrecoverable error on the SYSLCK file. 
Volume entry does not exist in this catalog. 


VSAM record management has found an error during ERASE. 
(Reason codes from VSAM record management - see Volume 
2.) 


Early exit. (Internal indicator; if found in CCACD1, it does nor 
indicate an error, but that the last O/C/EOV request for catalog 
open has completed.) 





Catalog Management error code-to-module relationship (Part 10 of 10) 
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DADSM Error Code-to-Module Relationship 


Reason 
Code 
Module Routine (Reg.15) . Meaning 





IKQWDSO0* Write completed successfully 
GETVIS failed 


IKQRDSOO Successful read 
GETVIS failed 


IKQRENOO* Rename successful 
Volume not mounted 
GETVIS failed 


IKQSCROO* Scratch successful 
‘08' Volume not mounted 
GETVIS failed 


IKQALLOO" ‘00’ Successful allocate 
‘08’ Volume not mounted 
No extents given in EXTENT card 
GETVIS failed 
CDLOAD failed 


IKQVTCOO ‘00' VTOC opened successfully 
‘40° GETVIS failed 
LOAD failed 


IKQPOPO00* ‘00’ 00 Successful VTOC label build 
‘28 40 No extents given 
64 GETVIS failed 


*Note: These modules also return codes issued by other internally called modules, 
including the common VTOC handler phase (IJJHCVH). 
IJJHCVH - Xx‘04' 1/O error reading VOL label 
x‘08' Volume not mounted 
X'0C' VTOC 1/0 error 
x'10’ A duplicate name was found during a 
write to the VTOC. 
VTOC full 
Extents overlap unexpired file 
Extents overlap protected, unexpired 
file 
Extents overlap VTOC 
A format-1, or the next label was not 
found on a VTOC read request. 
invalid label address 
. The specified extents overlap those of 
a protected expired file. 
GETVIS failed 
Security violation. 
Invalid VTOC share option. 
Extents overlap each other 
The caller supplied work area is too 
small. 
Format-4 VTOC label not found 
VOL 1 label not found. 
Extent block (JIB) processing failed 
Labels read are not format-1s or 
format-3s. 
A lock request for the VTOC is incon- 
sistent with a previous lock request. 
A VTOC lock request would result in a 
deadlock condition. 
An invalid control block was built by 
the common VTOC handler. 
An 1/O error occured on the system 
lock file. 
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Control Block Manipulation Error Code-to-Module Relationship 


Module 
IKQGEN 


IKQTMSD 
or 
IKQTMSF 


Figure 6.8 


Return 
Code 
(Reg. 15) 


X'00' 
X‘04' 


Meaning 


Successful completion 
An error has been 
detected 


Invalid use of the 
execute form of this 
macro instruction. 


CDLOAD failure 


Successful completion 
An error has been 
detected 


Same as for IKQGEN 
Same as for IKQGEN 


Meaning 


Invalid function type code 

Invalid control block type-code 

Invalid keyword type-code 

Not enough storage available 

User area too small 

Exit address is not specified in the input 
Inconsistent parameters 

The user area is not on a fullword 
boundary 


Since the return code is set by 

the macro expansion and not 

by IKQGEN, RO contents do not indicate 
an error code. 

The return code is set by the macro 
expansion, not by IKQGEN, and RO con- 
tains the return code from CDLOAD. 


Invalid function type-code. 

Invalid control block type code. 

Invalid keyword type-code 

Control block not of type 

specified 

The ACB is closed; it must be open 

The cluster is not key-sequenced (does 
not include an index) 

The EXLST entry is not present 

User area is too small (SHOWCB) 

Exit address is not specified in the input 
The RPL is active 

The ACB is open; it must be closed 

The exit address is not in the control block 
Inconsistent parameters 

The user area is not on a fullword 
boundary 

The parameter ’STRMAX' was specified, 
but LSR is not active. 


Same as for IKQGEN 
Same as for IKQGEN 
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OPEN Error Code-to-Module Relationship 





Error Return 
Code Code! 
(ACBERFLG) (Reg.15) 


Issuing 
Module 


IKQOPN 
IKQOPN 


IKQOPN 
IKQOPNCT 


IKQJIBSM 


IKQLAB 
IKQOPN 
IKQOPNOV 


IKQLAB 
IKQOPN 
IKQOPNOV: 
IKQOPNOV 
IKQOPN 


IKQOPNOV 


IKQOPNDS 
IKQOPNHC 


$$BOVSAM 
IKQLAB 

IKQOPN 

IKQOPNHC 
IKQOPNOV 
IKQOPNRD 
IKQOPNHC 


IKQOPNHC 


IKQOPNVC 


IKQOPNVC 


IKQOPN 


IKQOPNVC 


IKQOCIMR 


IKQOCIMR 


IKQOCIMR 


IKQOCIMR 


IKQOCIMR 
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Meaning 


Invalid ACB !D 
This ACB is already open 


The symbolic unit in the DLBL 
statement is invalid. 


Extent block processing failed. 


The address in the ASSIGN 
statement for the logical unit was 
IGN (assignment ignored). 


The address in the ASSIGN statement 
for the logical unit was UA 
(logical unit unassigned). 


Unable to automatically assign a logical 
unit number, 


The open disposition specified for the file 
conflicts with the other file characteristics. 


The volume serial numbers in the 
EXTENT statement do not match those in 
the catalog entry. 


No space available on any volume for 
primary allocation of a dynamic file. 


An attempt was made to open a NOALLO- 
CATION file which is not reusable. 


One or more VSAM processing modules 
cannot be loaded because the user’s 
partition is too small. 


An attempt was made to open a NOCI- 
FORMAT file using VSAM (ACB) access. 


An attempt was made to open a SAM 
ESDS without the VSE/VSAM Space 
Management for SAM Feature installed. 


An attempt was made to open a DTF 
whose file characteristics do not match 
the file characteristics of the VSAM cata- 
log. 


An attempt was made to open an unex- 
pired file for output using a DTF. 


The file to be opened has a name which 
begins with a restricted prefix. 


An attempt was made to open a nonSAM 
ESDS file using a DTF. 


An invalid file-id was detected during 
implicit define or implicit delete. 


Allocation specifications for implicit define 
conflict with the file characteristics speci- 
fied in the DTF. 


The file-id specified in your DLBL state- 
ment was not found in the catalog and in- 
sufficient allocation information is speci- 
fied for an implicit define. 


A catalog management error was detected 
during implicit delete. 


A catalog management error was detected 
during implicit define. 


OPEN error code-to-module relationships (part 1 of 4) 
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Error 
Code 


X'50' 


X'5C' 


X'60' 


X'64' 


X'68' 


X'6C’ 


X'6E' 


X'74' 


X'75' 


X'80’ 


X'84’ 


X'88' 


Figure 6.9 
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Return 
Code! 
(ACBERFLG) (Reg.15) 


X‘08' 


X'04' 


X‘04’ 


X'04' 


X'04' 


X'04' 


X‘08’ 


X'04' 


X'08' 


X'08' 


X‘08' 


X'08' 


Issuing 
Module 


IKQOPNOV 


IKQOPN 


IKQOPNHC 
IKQOPN 


IKQOPNOV 


IKQOPNAB 
IKQOPNHC 


IKQOPN 


IKQOPNHC 


IKQLAB 
IKQOPNOV 
IKQOPNRD 


IKQLAB 


IKQLAB 


$$BOVSAM 
IKQOPN 
IKQOPNAB 
IKQOPNAI 
IKQOPNDS 
IKQOPNHC 
IKQOPNNC 
IKQOPNOV 
IKQOPNPV 
IKQOPNRD 
IKQOPNRP 
IKQOPNUS 
IKQLAB 
IKQSTM 





Meaning 


An attempt was made to assign more than 
one volume of a multivolume data set to 
one unit when direct or keyed processing 
was specified in the ACB. 


LSR was specified in the ACB macro, but 
no message area was specified. Ignore 
this error code if there is no ACB with the 
DFR option in the resource pool. 


A data set which is unusable (due to a 
failure in recovery) was opened for input. 


Open encountered an empty alternate 
index in the upgrade set. 


The time stamp of the data set's volume 
does not match the system time stamp in 
the volume catalog entry. 


The system time stamps in the catalog 
entries for the data and index components 
of a data set do not match. This indicates | 
that the data has been updated separate- 
ly. 

Note: No warning is given if the index time 
stamp is greater than the data time stamp. 


An attempt was made to open an empty 

data set for input only; or to open a data 
set which was not closed properly after 

initial loading. 


The data set was not closed the last time 
it was processed. 


The symbolic unit specified in the 
EXTENT statement is not a 

valid device type, or invalid extents are 
specified. 

The DLBL statement is missing or the 
filename in the DLBL does not match the 
ACB. 


A permanent I/O error occurred while 
VSAM was reading the label information 
area. 


VSAM could not obtain a continuous 
area of virtual storage of the size 
required for work areas, control 
blocks, and buffers needed by VSAM. 


OPEN error code-to-module relationships (part 2 of 4) 
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6.34 


Error 
Code 
(ACBERFLG) 


Figure 6.9 
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Return 
Code! 
(Reg.15) 


Issuing 
Module 


IKQOPNHC 
IKQOPNAI 

IKQOPNRD 
IKQOPNUS 


IKQOPN 
IKQOPNHC 
IKQOPNOV 
IKQOPNAI 


IKQOPNHC 


IKQOPNAB 
IKQOPNAI 
IKQOPN 
IKQOPNHC 


IKQOPN 


IKQOPN 
IKQOPNHC 
IKQOCSHR 


IKQOPN 
IKQOPNHC 
IKQOCSHR 


IKQOPN 
IKQOPNHC 
IKQOCSHR 


IKQOPNAB 
IKQOPNHC 
IKQOCSHR 


IKQOPN 
IKQOPNCT 
IKQOPNHC 
IKQOPNAI 


Meaning 


A permanent I/O error occurred while 
VSAM was reading or writing a 
catalog entry. 


No valid entry was found in the 
catalog for this ACB or 

for the alternate index structure 
related to this ACB. 


Security verification failed: the password 
specified in the ACB, or supplied by the 
operator, for a specific level of access 
does not match the corresponding pass- 
word in the catalog entry. 


The operands specified in the ACB are 
inconsistent with each other or with 
information in the catalog entry, such as 
keyed processing specified for an ESDS 
or DFR specified when LSR is inactive. 
User buffers were specified with keyed 
access (they may be specified only with 
CNV access) or with LSR. 


A permanent I/O error was detected 
on the system lock file. 


The system lock table is not large 
enough to accommodate the concurrent 
requests. 


The system lock file is not large 
enough to accommodate the concurrent 
requests. 


The data set is not available 

because it is being updated, loaded, 

or reset by (and under exclusive control 
of) another ACB or because it has been 
flagged read only by Access Method Ser- 
vices. 


An error occurred while a catalog was 
being opened. Possibly an attempt to 
get additional storage failed, or an 
1/O error occurred while VSAM was 
reading the VTOC, a VTOC label, or a 
cluster. 
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| Error Return 
Code Code! Issuing 
(ACBERFLG) (Reg.15) Module Meaning 


X'BC' X'08' IKQOPN ACB already active. 

Xx‘CO' X‘08' IKQOPNHC A data set which is unusable (because of 
a failure in recovery) was opened for out- 
put. 

X'C4' X'08' IKQOPNAB Access to data was requested via an 
empty alternate index. 

X'D4’ x‘08' IKQOPNAB LSR is specified, but the data set being 
opened is empty (which implies that it is to 
be loaded). 

X'D8' X‘08' IKQOPNRP LSR is specified, but the keylength of the 
data set being opened is greater than the 
maximum keylength specified for the re- 
source pool. 

X‘DC’ X‘08' IKQOPNRP LSR is specified, but the Cl size of the 
data set being opened is greater than the 
largest buffer size specified for the re- 
source pool. 

X‘E4' X'08' IKQOPNRP LSR is specified, but there is no resource 
pool defined; may also be caused by 
problems while loading the resource table. 


X'E8’ X‘08' IKQOPNRD Reset was specified for a non-reusable 





data set and the data set is not empty. 
X'F8' X‘08' IKQLAB IKQLAB internal interface error with 
LABEL or EXTRACT macro. 
X'FE’ xX'08' IKQOPN Open detected an unexpected return 
IKQOPNHC code from the lock manager. 
IKQOCSHR 
X'FF’ X'08' IKQOPNAI Unexpected return from catalog locate 
IKQOPNDS function. 
IKQOPNHC 
IKQOPNRD 


IKQOPNUS 


1 The contents of register 15 have the following meaning: 


x‘'00' Open was successfully completed. 

X'04' All ACBs were opened successfully, but one or more ACBs had a 
warning message. 

X‘08' One or more ACBs were not successfully opened. 


Note that register 15 contains the worst return code encountered while opening a list 
of ACBs. This means that some of the ACBs in the list may have been opened success- 
fully, even though register 15 contains X‘04' or X'08’. 


2 This code is ignored by OPEN, but is meaningful to catalog and DADSM routines. 


Figure 6.9 OPEN error code-to-module relationships (part 4 of 4) 


Licensed Material — Property of IBM Section 6. Diagnostic Aids 6.35 


CLOSE and TCLOSE Error Code-to-Module Relationship 


Error Return 
Code Code Issuing 


6.36 


(ACBERFLG) 


Figure 6.10 
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Module 
IKQCLOOO 


IKQCLOOO 
$$BCVSAM 
$$BTCLOS 
IKQCLCAT 
IKQCLRDD 
IKQCLOOO 
IKQCLCAT 


IKQCLCAT 


IKCLOOO 
IKQCLCAT 


IKQCLOOO 
IKQCLCAT 


IKQCLOOO 
IKQCLCAT 


IKQCLO00 


IKQCLOOO 


IKQCLOO0O 
IKQSMACL 


IKQCLOOO 


Meaning 


Invalid control block ID or ACB address 
not in OAL. 


ACB is already closed or invalid 
control block structure. 


Disposition processing failed 

during close. 

VSAM could not obtain a continous 
area of virtual storage large enough for 
the work area. 


A permanent I/O error occurred while 
VSAM was reading or writing a catalog 
entry. 

A permanent I/O error was detected 

on the system lock file. 

The system lock table is not large 
enough to accommodate the concurrent 
requests. 

The system lock file is not large 

enough to accommodate the concurrent 
requests. 

An internal error occurred while VSAM 
was completing outstanding |/O requests. 
The ACB is busy; it is being used, for 
example, by SHOWCB or TESTCB. 
Resource poo! is invalid. 

Automatic close of the DTF for a 
managed-SAM file failed. 

Close detected an unexpected return 
code from the lock manager. 
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SHOWCAT Error Code-to-Module Relationship 


Issuing 
Module Meaning 


IKQSCAT VSAM successfully completed the request 

IKQSCAT The specified work area is less than the minimum size 
(64 bytes) or too small to display all associated objects 
(in this case, as many objects as possible are dis- 
played). 

IKQSCAT Either the ACB address is invalid, or the VSAM master 
catalog does not exist or could not be opened. 

IKQSCAT CDLOAD failure while VSAM routines were being 
loaded 

IKQSCAT The specified object or control interval does not exist. 

IKQSCAT An 1/O error occurred while accessing the catalog. 

IKQSCAT The specified Cl number is invalid. 

IKQSCAT The specified object is not a cluster, data set, index, 
alternate index, path, or upgrade set. 


IKQSCAT The information in the catalog is at a different level 
than that in the CRA. 


IKQSCAT The SHOWCAT module received an unexpected error 
code from catalog management. 

IKQSCAT Error while searching the label area for the data set 
name. 


IKQSCAT EXTOPT field name is not valid for SHOWCAT. 
IKQSCAT EXTOPT specified, but record type not D or I. 


In the case of return codes OC, 14, 18, 1C, 24, 28, or 34, the SHOWCAT 
work area contains the return code and reason code issued by catalog 
management and the ID of the module in which the error was detected. In the 
case of return code X'2C’, the work area contains the return code from 
IKQLAB, as shown in Figure 6.7. The format of the work area is then: 

Offset Length Description 

0 2 Length of work area 

2 2 Catalog management or IKQLAB return code 

4 2 Catalog management reason code 

6 2 Catalog management module ID 





Figure 6.11 SHOWCAT error code-to-module relationships 
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BLDVRP and DLVRP Error Code-to-Module Relationship 


Return 
Code Issuing 
Macro (Reg. 15) Module Description 


BLDVRP X‘OO' IKQBRP Request was successfully completed 


X'04' IKQBRP A resource pool already exists for the 
partition 


X'0C’ IKQBRP CDLOAD failure 


X'14' IKQBRP STRNO is specified as less than one or more 
than 255 


X'18’ IKQBRP The specified BUFFERS parameter is invalid 


DELVRP X'‘O0O’ IKQDRP Request was successfully completed 
X'04' IKQDRP There is no resource pool to be deleted 


X'08' IKQDRP There is at least one open data set still using 
the resource pool 


X‘0C' IKQDRP CDLOAD failure 





Figure 6.12 Error codes for BLDVRP and DLVRP macros 


Catalog Management Procedure Cross Reference 
The following table lists, for each catalog management procedure, the 
names of the other procedure(s) that call it. 


To Procedure: The called procedure. 


To Module: The module to which the called procedure belongs. Only the 
last two characters of the module name are given; the first six characters are 
always IGGOCL. 


From Procedure: The calling procedure. 


‘From Module: The module to which the calling procedure belongs. Only 
the last two characters of the module name are given; the first six characters 
are always IGGOCL. 


Sequence: The number indicates that this is the nth call that the calling 
procedure makes. 


For example, procedure IGGPALEC (in module IGGOCLBE) can be called 
by either IGGPALSA (in module IGGOCLBE) or IGGPALVR (in module 
IGGOCLBN). When IGGPALSA calls IGGPALEC, it is IGGPALSA’s 4th 
call to another procedure. When IGGPALVR calls IGGPALEC, it is 
IGGPALVR’s 8th call to another procedure. 
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To Procedure 


IGGPACDV 
IGGPADCI 


IGGPADGO 
IGGPAPGO 
IGGPAIX 
IGGPALAE 
IGGPALBC 


IGGPALBT 
IGGPALEC 


IGGPALF1 
IGGPALGV 
IGGPALIX 
IGGPALMD 
IGGPALNM 
IGGPALPL 


IGGPALSA 
IGGPALSV 
IGGPALT 

IGGPALT2 
IGGPALVA 


IGGPALVE 
IGGPALVL 
IGGPALVO 
IGGPALVR 


IGGPALY 
IGGPANCI 


IGGPAOCI 


IGGPASPP 
IGGPASPT 


IGGPAXCI 


IGGPBAMO 
IGGPBASP 
IGGPBAWP 
IGGPBCAN 
IGGPBCRA 
IGGPBDLT 


IGGPBDSH 


IGGPBDSS 
IGGPBMR 
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To Module 


AB 
AG 


Catalog management procedure cross reference (part 1 of 6) 





From 
From Procedure 


IGGOCLC9 
IGGPAOCI 
IGGPAXCI 
IGGPISCI 

IGGPXDGO 
IGGPADGO 
IGGPCDVR 
IGGPALVA 
IGGPALIX 

IGGPALSA 
IGGPALVA 
IGGPALVL 
IGGPALMD 
IGGPALSA 
IGGPALVR 
1GGPALNM 
IGGPALF 1 
IGGPALEC 
IGGPALT 

IGGPALT 

IGGPALVE 
IGGPALVR 
IGGPALVA 


iIGGPALF1 


IGGPCDVR 
IGGPXLT2 
IGGPALIX 
IGGPALVL 
IGGPALVR 
IGGPALT 
IGGPALVR 
IGGPALIX 
IGGPALVL 
IGGPALT 
IGGPAOCI 
IGGPAXCI 
IGGPISCI 
IGGPBAWP 
\GGPCSMP 
IGGPDAIN 
IGGPDCCE 
IG@GPDCPC 
IGGPNUPG 
IGGPAIX 
IGGPADGO 
IGGPAGOP 
IGGPADGO 
IGGPAGOP 
IGGPDEFS 
IGGPDOIT 
IGGPDOWN 
IGGPMBGO 
IGGPMVAR 
1GGPRISE 
IGGPSNK2 
IGGPPATH 
IGGPPATH 
IGGPPATH 
IGGPDFBO 
IGGPCADR 
IGGPGVL 
IGGPUPLT 
IGGPDFBO 
IGGPDFBO 
IGGPEDS 
IGGPMEBM 
IGGPRELE 
IGGPSALS 
tGGPSSCR 
IGGPXDGO 
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cg 
AG 
AG 
AG 
BT 
AW 
AT 
BE 
BE 
BE 
BE 
BE 
BD 


To Procedure 


IGGPBNUN 
IGGPBOUT 
IGGPBSCR 
IGGPBSGT 


IGGPCADR 
IGGPCCCR 


IGGPCCLN 
IGGPCDSD 
IGGPCOVR 
IGGPCEXT 


IGGPCGO 
IGGPCHAC 


IGGPCHSP 
IGGPCIND 
IGGPCKAU 


iIGGPCKCC 
IGGPCKEN 


IGGPCKEX 


IGGPCKLC 
IGGPCLBF 


IGGPCLGT 
IGGPCNBO 
IGGPCNST 
iGGPCOBT 
IGGPCRAO 


IGGPCRAP 
IGGPCRBO 


IGGPCRDI 

IGGPCRTC 
IGGPCRVL 
IGGPCSAL 
IGGPCSDG 
IGGPCSHG 
IGGPCSMP 
IGGPDAIN 

IGGPDAIX 

iGGPDALR 


IGGPDANL 





To Module 








From Procedure 


IGGPXEL2 
IGGPXVAL 
IGGPDFBO 
IGGPDUND 
IGGPDFBO 
IGGPCKAU 
IGGPCKCC 
IGGPCLGT 
IGGPPWVR 
IGGPCCLN 
IGGPADCI 
IGGPAOCI 
IGGPAXCI 
IGGPDEFC 
IGGPDELC 
IGGPDUND 
IGGPISCI 
IGGPRCU 
IGGPCDVR 
IGGPDFS2 
IGGPACDV 
IGGPSSWD 
IGGPUPDE 
IGGPMGO 
IGGPDOIT 
IGGPFRE 
IGGPUTE 
IGGPGVL 
IGGPDCSP 
IGGPACDV 
iGGPCDVR 
IGGPCRAP 
IGGPDEFS 
IGGPLSTC 
IGGPPRPW 
IGGPCKAU 
IGGPPWVR 
IGGPDSEM 
IGGPPASE 
IGGPCKAU 
IGGPCKCC 
IGGPCLGT 
IGGPPWGT 
IGGPPWVR 
IGGPLVAL 
IGGPDBDI 
IGGPOCMB 
IGGPODUND 
IGGPPWVR 
IGGPDSPO 
iGGPBAWP 
IGGPDEFS 
IGGPOPEN 
IGGPPRDS 
IGGPACDV 
IGGPBCRA 
IGGPCRVL 
IGGPDEFS 
IGGPBCRA 
IGGPDEFS 
IGGPBCRA 
IGGPUPDE 
IGGPDFS2 
IGGPDFS2 
IGGPXDGO 
IGGPDEFA 
IGGPDLCL 
IGGPAIX 
IGGPDSCB 
IGGPDAIN 

















From 
Module 
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To Procedure 


iGGPDATA 


IGGPDAVO 
IGGPDBCV 
iGGPDBDI 


IGGPDBSF 


iGGPDBVO 
IGGPDCAV 


IGGPDCBE 
{GGPDCBO 


iGGPDCCB 
I@GPDCCC 
IGGPDCCE 


IGGPDCCI 

IGGPDCCO 
IGGPDCDA 
IGGPDCDE 


iGGPDCEB 
IGGPDCFL 
IGGPDCHD 
IGGPDCHK 
1GGPDCIM 
IGGPDCIS 
IGGPDCIX 
IGGPDCLD 
iGGPDCMB 
IGGPOCME 
IGGPDCNV 
IGGPDCOC 
IGGPDCON 
IGGPDCPB 
IGGPDCPC 
IGGPDCPR 
{\GGPDCPT 
IGGPDCRC 


{GGPDCSF 
iGGPDCSP 
IGGPDCSS 
IGGPDCVO 
IGGPDCVS 
IGGPOCWC 
IGGPDDCE 
IGGPDDEP 


IGGPDDNP 
IGGPDDRT 


IGGPDDSA 
IGGPDDTC 


IGGPDEDD 
iGGPDEDE 
IGGPDEF 

(GGPDEFA 
IGGPDEFC 
IGGPDEFS 
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To Module 


Catalog management procedure cross reference (part 2 of 6) 





From Procedure 


iGGPDDSA 
IGGPDRSP 
IGGPDEFA 
IGGPDBVO 
IGGPAIX 
IGGPDSCB 
IGGPAIX 
IGGPDSCB 
{GGPDCMB 
IGGPAIX 
IGGPDEF 
IGGPDEFC 
IGGPBCRA 
IGGPDCOC 
IGGPDCOC 
IGGPDSPC 
IGGPDCPC 
iGGPDRDA 
IGGPDCCO 
IGGPDSPC 
iGGPDSCB 
IGGPBASP 
IGGPDDEP 
IGGPDCBE 
IGGPDCVO 
IGGPDCVO 
IGGPCDVR 
iGGPDCCC 
IGGPDRSP 
I{GGPDCVO 
IGGPDCVO 
IGGPDBDI 
IGGPDCEB 
IGGPDBDI 
IGGPDEFC 
iIGGPDCSP 
IGGPDCBE 
iGGPDCSP 
IGGPDCOC 
IGGPODCCC 
iPPCRVL 
IGGPDCHD 
IGGPDCIX 
IGGPDCLD 
(GGPDCME 
IGGPDCAV 
IGGPDCVS 
IGGPDEFC 
IGGPDEFC 
IGGPDCDA 
IGGPDCAV 
IGGPDSPC 
IGGPAIX 
IGGPDEF 
iGGPGVSA 
IGGPDCAV 
IGGPDDSA 
IGGPDRSP 
IGGPDRSP 
IGGPDDSA 
IGGPDRSP 
IGGPVMSC 
IGGPODEP 
IGGPCDVR 
IGGPCDVR 
IGGPDSCB 
IGGPASGN 
IGGPCDVR 
IGGPCONV 
IGGPDCSP 





From 
Module 





To Procedure 


IGGPDEIN 
IGGPDEL 
IGGPDELA 
IGGPDELC 


IGGPDELN 
IGGPDELO 


IGGPDELP 
IGGPDELS 
IGGPDELU 


IGGPDELX 
IGGPDELY 
IGGPDEL2 
IGGPDEMV 


IGGPDESH 
IGGPDEUN 
IGGPDEVG 
IGGPDEXA 


IGGPDEXB 


IGGPDEXC 


IGGPDEXD 


IGGPDEXP 


IGGPDEXT 


IGGPDFBI 


IGGPDFBO 
IGGPDFRE 
IGGPDFRS 
IGGPDFSC 
IGGPDFS2 
IGGPDGO 


\GGPDGOP 


IGGPDISA 

IGGPDJCL 
|GGPDLCD 
IGGPDLCL 
IGGPDLCR 
IGGPDLDS 


IGGPDOLER 
IGGPDLET 
IGGPDLEX 
IGGPDLSC 
IGGPOLSF 





To Module 
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From Procedure 


IGGPDSPO 
iGGPMVAR 
IGGPCDVR 
IGGPDEL 
IGGPCDVR 
IGGPDELU 
IGGPDELC 
IGGPDAIX 
IGGPDELX 
IGGPDLCL 
IGGPDLSF 
IGGPDEL 
IGGPCDVR 
IGGPDLDS 
IGGPDELE 
IGGPDLSF 
IGGPDEL 
IGGPDLCL 
IGGPXEL2 
IGGPDELA 
iGGPVMSC 
IGGPVMSC 
IGGPDUND 
IGGPVMSC 
IGGPDAIX 
IGGPDELP 
IGGPDELX 
IGGPDLCL 
IGGPDLTC 
IGGPDAIX 
IGGPDELP 
iGGPDELX 
IGGPDELY 
IGGPDPTH 
IGGPDAIX 
IGGPDPTH 
IGGPDBCV 
IGGPDBVO 
IGGPDCMB 
IGGPDSEX 
IGGPDSSP 
IGGPDELX 
IGGPDLCL 
IGGPLBLS 
IGGPSPC 
IGGPCNBO 
IGGPDFBO 
IGGPDBDI 
IGGPDFRS 
IGGPDBDI 
IGGPDCAV 
IGGPDEFS 
IGGPDEL2 
IGGPMGO 
IGGPDEL2 
IGGPMGO 
IGGPDRSP 
IGGPDLDS 
IGGPDELS 
IGGPDEL 
IGGPDELS 
IGGPDAIX 
IGGPDELX 
IGGPDELU 
IGGPDLCL 
IGGPDELC 
IGGPDELS 
IGGPDELS 
IGGPDELS 
IGGPDELS 








From 
Module 





To Procedure 


IGGPDLSH 
IGGPDLTC 
IGGPDLTS 
IGGPDLVC 
IGGPDLVM 
IGGPDLXT 


IGGPDMDS 
|IGGPDMOP 
IGGPDOIT 
IGGPDORG 
IGGPDOWN 
IGGPDPBI 


IGGPDPTH 


IGGPDRCA 
IGGPORCS 
IGGPDRDA 


IGGPDRNG 
IGGPDRPG 
IGGPDRSP 
IGGPDSCB 


IGGPDSEM 
IGGPDSEX 
IGGPDSMD 


IGGPDSPC 
IGGPDSPF 


IGGPDSPO 
IGGPDSSP 


IGGPDSTS 
IGGPDSTY 


iIGGPDSXT 
IGGPDTIM 


IGGPDUND 


IGGPDUSC 
IGGPDVMV 
IGGPDVSC 


IGGPDVV 
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To Module 


BL 
BG 
BL 
iBL 
BL 
BG 
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From 
From Procedure 


IGGPDELU 
IGGPDELS 
IG@GPDEL 
IGGPDELS 
IGGPDELS 
IGGPDELS 
IGGPDAIX 
IGGPDEL 
IGGPDELA 
IGGPDELO 
IGGPDELP 
IGGPDELX 
IGGPDELY 
IGGPDEXP 
IGGDJCL 
IGGPDLCL 
IGGPDLDS 
IGGPDPTH 
IGGPDLSF 
IGGPDCMB 
IGGPRIO 
IGGPSPC 
IGGPSNK2 
IGGPDCCC 
IGGPDCCO 
IGGPDAIX 
IGGPDELX 


i IGGPDLCL 


IGGPDBVO 
IGGPDBDI 
IGGPAIX 

IGGPDSCB 
IGGPDBVO 
IGGPDCAV 
IGGPDRDA 
IGGPDEF 

IGGPGVL 

IGGPAIX 

IGGPDSPO 
IGGPCDSD 
1GGPCSDG 
IGGPCSHG 
IGGPDRDA 
IGGPAIX 

IGGPDSCB 
IGGPDBDI 
IGGPDBCV 
IGGPDBVO 
IGGPVMSC 
IGGPBASP 
IGGPDDEP 
IGGPDEFS 
IGGPDEDE 
IGGPDEFS 
IGGPAIX 

IGGPBAMO 
IGGPDCBO 
IGGPDEFA 
IGGPDELA 
IGGPDFBO 
IGGPDLDS 
IGGPDSCB 
IGGPDELA 
IGGPVMSC 
IGGPDELA 
IGGPVMSC 
IGGPDELS 
IGGPDLSF 
IGGPDE XT 
IGGPDORG 
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To Procedure 


IGGPDWAI 


iGGPDXDS 
IGGPEDS 
IGGPEMIO 
IGGPEMSG 
IGGPERAS 
IGGPEVOL 
IGGPEXO 


IGGPEXPD 


IGGPEXT 


IGGPFCHK 
IGGPFCON 
IGGPFGRW 
IGGPFLIM 


IGGPFRE 
iGGPFREE 
IGGPFVXT 


iIGGPF4PR 
iIGGPF4RD 





To Module 
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From Procedure 


IGGPRLAB 
IGGPBASP 
IGGPDDEP 
IGGPDLSF 
IGGPSALS 
IGGPIORA 
IGGPIORA 
IGGPDLDS 
IGGPCHSP 
IGGPDOIT 
IGGPOPEN 
IGGPRIO 
IGGPDOWN 
IGGPMVAR 
IGGPSINK 
IGGPALGV 
IGGPALIX 
IGGPALVA 
IGGPALVL 
IGGPALVR 
IGGPALY 
IGGPCKEX 
IGGPDAIX 
IGGPDEDD 
IGGPDELC 
IGGPDELP 
IGGPDELS 
IGGPDELX 
IGGPDELY 
IGGPDEMV 
IGGPDESH 
IGGPDEVG 
IGGPDEXP 
IGGPDLCD 
IGGPDLCL 
IGGPDLSF 
IGGPDLTC 
IGGPDPTH 
IGGPDSEM 
IGGPGVLM 
IGGPINIT 
IGGPLSTC 
IGGPPGAO 
IGGPPUPG 
IGGPRELE 
IGGPSALL 
IGGPSALS 
IGGPSVOL 
IGGPUPG 
IGGPDCSP 
IGGPDCCC 
IGGPAIX 
IGGPDDCE 
IGGPDEFS 
IGGPVCHK 
IGGPANCI 
IGGPCRAO 
IGGPAIX 
IGGPBDLT 
IGGPEVOL 
IGGPGVL 
IGGPGVLG 
IGGPGVLM 
IGGPUPLT 
IGGPDEFS 
IGGPCRBO 
IGGPCRVL 
IGGPDCBO 
IGGPDELC 





IGGPDLET 
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To Module From Procedure 


IGGPF4WR 


IGGPGDVC 
IGGPGET 
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IGGPDLTS 
IGGPOSTS 
IGGPF4PR 
IGGPCRBO 
IGGPCRVL 
IGGPDCBO 
IGGPDELC 
IGGPDLET 
IGGPDLTS 
IGGPDSTS 
IGGPF4PR 
IGGPCRVL 
IGGPAIX 
IGGPALEC 
IGGPALIX 
IGGPALNM 
IGGPALT 
IGGPALVE 
IGGPALY 
IGGPBAMO 
IGGPBCAN 
IGGPBCRA 
IGGPBOUT 
IGGPBSGT 
IGGPCKCC 
IGGPCKEN 
IGGPCLGT 
IGGPCNBO 
IGGPCRAP 
IGGPCRBO 
IGGPCRVL 
IGGPDAIN 
IGGPDAIX 
iGGPDCPC 
IGGPDDCE 
IGGPDEDE 
IGGPDEFS 
IGGPDELC 
IGGPDELP 
IGGPDELX 
IGGPDELY 
IGGPDEUN 
\IGGPDFBO 
IGGPDJCL 
IGGPDLDS 
IGGPDLET 
IGGPDLSF 
IGGPDLTC 


‘/|GGPDPTH 


iGGPDSEM 
IGGPDUND 
|GGPFGRW 
IGGPGETM 
IGGPGREC 
IGGPGVLM 
IGGPINMD 
IGGPISCI 
IGGPLSTC 
IGGPPASE 
IGGPPRDS 
IGGPPRPW 
IGGPPWGT 
IGGPRELE 
IGGPRUPG 
IGGPSALL 
IGGPSCA 
IGGPSCAT 
IGGPSPSC 
IGGPSSWD 
IGGPUPDE 





From 
Module 


To Procedure 


IGGPGETM 
IGGPGLUB 


IGGPGNEX 


IGGPGREC 


IGGPGREL 
IGGPGREP 
IGGPGTBF 
IGGPGUPG 


IGGPGVAL 


IGGPGVL 


IGGPGVLG 
IGGPGVLM 
IGGPGVSA 


IGGPIDMP 


Catalog management procedure cross reference (part 4 of 6) 








To Module 
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From Procedure 


IGGPUPG 
IGGPVMSC 
IGGPLTRN 
IGGPBMR 
IGGPCRAO 
IGGPEMIO 
IGGPADGO 
IGGPAGOP 
IGGPDOWN 
IGGPMBGO 
IGGPMVAR 
IGGPADGO 
iGGPAGOP 
IGGPDEL2 
IGGPGREL 
IGGPGREP 
IGGPGVAL 
IGGPMBGO 
IGGPMVAR 
IGGPSCNF 
IGGPSFPL 
IGGPSGOP 
IGGPSNK2 
IGGPTSTS 
iGGPXDGO 
IGGPXEL2 
IGGPXEXS 
IGGPXVAL 
IGGPAGOP 
IGGPLOC2 
IGGPDFBO 
IGGPGREC 
IGGPALY 
IGGPUPG 
IGGPALT2 
IGGPDEIN 
IGGPDOWN 
IGGPLOC2 
IGGPMVAR 
IGGPRISE 
IGGPTSTS 
IGGPXDGO 
IGGPXEL2 
IGGPXEXS 
IGGPXVAL 
IGGPAIX 
IGGPDEF 
IGGPGVL 
IGGPDFSC 
IGGPAIX 
IGGPGVL 
IGGPACDV 
IGGPALVA 
IGGPCKEN 
IGGPCRAO 
IGGPDCAV 
IGGPDCCC 
IGGPDCDE 
IGGPDCHK 
IGGPDEDE 
IGGPDELC 
IGGPGET 
iGGPGTBF 
IGGPITER 
IGGPLAT2 
IGGPOPEN 
IGGPRPLM 
IGGPSCA 
IGGPSCNC 
IGGPSVOL 








From 
Module 





To Procedure 


iIGGPIGOP 


IGQPINIT 


IGGPINMD 
IGGPIORA 


IGGPIOSI 
IGGPISCI 


IGGPITER 
IGGPIVER 
IGGPLOC 
IGGPLOC2 
IGGPLSTC 
IGGPLTRN 
IGGPLVAL 
IGGPLVST 
IGGPMBGO 
IGGPMCO 
IGGPMCO2 


IGGPMEBM 
IGGPMEXT 


IGGPMGO 


IGGPMOD 


IGGPMODC 
IGGPMVAR 
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To Module 


Catalog management procedure cross reference (part 5 of 6) 


IGGPXDGO 
IGGPXEL2 
IGGPXLT2 
IGGPADGO 
IGGPAGOP 
IGGPASPT 
IGGPMGO 
IGGPSSWD 
IGGPUPDE 
IGGPCKAU 
IGGPADCI 
IGGPFRE 
IGGPISCI 
IGGPUTE 
IGGPSCAT 
IGGPDEFS 
IGGPSALL 
IGGPDCCC 
IGGPDEFS 
IGGPACDV 
IGGPSCNF 
'IG@GPCDVR 
iIGGPLOC2 
IGGPGVAL 
IGGPCKAU 
IGGPMVAR 
IGGPACDV 
IGGPDCOC 
IGGPMCO 
IGGPDCSP 
IGGPSSWD 
IG@GPUPDE 
IGGPAGOP 
IGGPMBGO 
IGGPMVAR 
IGGPALMD 
IGGPALSA 
IGGPALVE 
IGGPALVR 
IGGPBAMO 
IGGPBCAN 
IGGPBDSH 
IGGPBDSS 
(GGPBOUT 
IGGPCNBO 
IGGPCRDI 
IGGPCRVL 
IGGPDAIX 
IGGPDAVO 
j}G@GPDCME 
IGGPDEDD 
IGGPDELP 
IGGPDELX 
IGGPDELY 
IGGPDESH 
IGGPDEUN 
IGGPDLSH 
IGGPDMDS 
IGGPDMOP 
IGGPDPTH 
IGGPOSMD 
t{GGPMEXT 
IGGPMODC 
IGGPMVOL 
IGGPNUPG 
IGGPRELE 
IGGPSALL 
IGGPUPG 
IGGPAIX 
iGGPALT2 
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From 
From Procedure 


To Procedure 


IGGPMVGO 
IGGPMVOL 


IGGPNFND 
IGGPNUPG 
IGGPOPEN 
IGGPPAD 


IGGPPART 
IGGPPASE 
IGGPPATH 
IGGPPDE 


IGGPPGAO 
IGGPPIN 
IGGPPING 
IGGPPRDS 
IGGPPREC 


IGGPPRPW 


IGGPPTBF 


IGGPPUPC 


iGGPPUTM 


IGGPPWGT 
IGGPPWVR 
IGGPRAND 
iGGPRBAP 


IGGPRCCR 


IGGPRCU 
IGGPROLB 
IGGPRELE 
IGGPRIO 
IGGPRISE 





To Module 


AW 
BB 


BR 
CP 


EG 


CA 


CB 


EG 


BR 


BM 
BM 
FB 

CG 


EG 





From Procedure 


IGGPADGO 
IGGPSSWD 
IGGPUPDE 
IGGPEMSG 
IGGPUPG 
IGGPRIO 
IGGPALNM 
IGGPBAWP 
IGGPCLBF 
iGGPDCPC 
IGGPDEFS 
IGGPFGRW 
IGGPPREC 
IGGPBMR 
IGGPPATH 
IGGPCDVR 
IGGPALNM 
IGGPCRBO 
IGGPDELC 
IGGPDELP 
IGGPDELY 
IGGPDEL2 
IGGPDEUN 
IGGPOLET 
IGGPDPTH 
IGGPDUND 
IGGPNUPG 
IGGPRIO 
IGGPSNK2 
IGGPPASE 
iGGOCLC9 
IGGPPIN 
IGGPCRVL 
IGGPDEL2 
IGGPDOWN 
IGGPGNEX 
IGGPGREC 
IGGPRISE 
IGGPSFPL 
IGGPSNK2 
IGGPAIX 
IGGPBASP 
IGGPDCCE 
IGGPPREC 
IGGPALT 
IGGPALY 
IGGPCSMP 
IGGPDELS 
IGGPDLSF 
IGGPPRDS 
IGGPPREC 
IGGPPUTM 
IGGPBMR 
IGGPGETM 
IGGPCKAU 
IGGPCKAU 
IGGPGVSA 
IGGPCCCR 
IGGPRCCR 
IGGPAXCI 
IGGPISCI 
IGGPOPEN 
IGGPPAD 
IGGPPDE 
IGGPRCU 
IG@GOCLC9 
IGGPCRAO 
IGGPUPD 
IGGPXIO 
IGGPDEIN 





From 
Module 


AW 
BB 
BB 
AF 
CD 
CG 
BD 
CP 
CB 
AP 
AQ 
CA 
AW 
BR 
CP 
AT 
BD 
CR 
AF 
Cx 
CX 
AV 
AN 
BL 
CX 
AN 
cD 
CG 
BW 
CP 
cg 
FA 
Cs 
AV 
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To Procedure 


IGGPRLAB 
IGGPRPLF 


IGGPRPLM 


IGGPRUPG 


(GGPSALL 


IGGPSALS 
IGGPSCA 


IGGPSCAT 


IGGPSCAX 


IGGPSCNC 


IGGPSCNF 
IGGPSDSP 


IGGPSET 


iIGGPSFPL 


|IGGPSGOP 


IGGPSHIN 
IGGPSHNK 


IGGPSINK 

IGGPSNK2 
IGGPSPSC 
IGGPSSCR 


IGGPSSWD 
IGGPSVOL 


IGGPTCMP 
IGGPTRPL 


IGGPTSTS 
IGGPUPD 


I@GPUPDE 
IG@GPUPG 
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To Module 


Catalog management procedure cross reference (part 6 of 6) 











From 
From Procedure 


IGGPBMAT 
IGGPDELC 
IGGPRCU 
IGGPSCA 
IGGPCRAP 
IGGPSCA 
IGGPSCAT 
IGGPALY 
IGGPNUPG 
(GGPUPG 
IGGPALSA 
IG@GPCRVL 
IGGPCSAL 
IGGPDCNV 
IGGPOCSP 
IGGPDSPO 
IGGPSALL 
|GGPCDVR 
IGGPDCOC 
IGGPSCAT 
IGGPVCAX 
IGGPACDV 
IGGPCDVR 
IGGPDEFS 
IGGPDELC 
IGGPBCRA 
IGGPCRAO 
IGGPDLCR 
IGGPSCA 
IGGPSOSP 
IGGPACDV 
IGGPEXT 
IGGPMOD 
IGGPEXT 
IGGPLOC 
IGGPCRBO 
IGGPDELC 
IGGPDEDD 
IGGPDEMV 
IGGPDESH 
IGGPDEVG 
I@GPMOD 
IGGPUPD 
IGGPADGO 
IGGPDEL2 
IGGPMGO 
IGGPXVAL 
IG@GPLOC2 
IGGPDOWN 
IGGPMVAR 
IGGPRISE 
IGGPSINK 
IGGPDEIN 
IGGPRISE 
IGGPDEIN 
IGGPCKAU 
IGGPBNUN 
IGGPVMSC 
IGGPUPDE 
IGGPSSWD 
IGGPUPDE 
IGGPTSTS 
IGGPPDE 
IGGPPUPC 
IGGPSCNF 
IG@GPSFPL 
IGGPACDV 








To Procedure 


IGGPUPLT 
(GGPUPUP 


IGGPVCHK 
1GGPVMSC 


IGGPVMTV 


IGGPXDGO 
IGGPXEL2 
IGGPXEXS 
{GGPXEXT 
IGGPXIO 


IGGPXLT2 
IGGPXMOD 
IGGPXVAL 
IGGPXVOL 
IKQALLOO 
iKQRDSOO 


IKQRENOO 
IKQSCROO 


IKQVTCOO 


To Module From Procedure 


IGGPDELX 
IGGPGVSA 
IGGPRISE 
IGGPDSPO 
IGGPANCI 
IGGPDCHK 
IGGPDVV 
IGGPFLIM 
IGGPDFBO 
IGGPDJCL 


IGGPPRDS 
IGGPPUPC 
IGGPRCCR 
IGGPRIO 

IGGPTRPL 


IGGPGVAL 
IGGPXVAL 

IGGPDEFS 

IGGPCOBT 
IGGPCSDG 
IGGPDVSC 
IGGPF4RD 

IGGPALSV 

IGGPBSCR 
IGGPDCBO 
IGGPDLSC 
IGGPDUSC 
IGGPDVSC 
IGGPSDSP 
IGGPCOBT 
IGGPCSDG 
IGGPDVSC 


IGGPF4WR 


From 
Module 
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Service Aids 


Service aid phases are available for: 


e Enabling and disabling snap dumps within the VSAM component. 


¢ Obtaining snap dumps of control blocks. 


e Using UPSI 


to obtain diagnostic information for the VSAM catalog. 


¢ Maintaining VTOC and VOLI labels on DASD. 
e Loading a VSAM phase or a program you have written. 


The service aid phases IKQVDUMP and $$BCVS03 are included in the 
link-edit of VSAM. The other three phases, IKQVEDA, IKQVDU, and 
$$BCVS04 can be placed in the core image library by executing the follow- 


ing job. 
// JOB 
// OPTION 
INCLUDE 
/* 


// EXEC 
/& 


Enabling and Disabling Snap Dumps 


JOBNAME 
CATAL 
IKQCLNLK 


LNKEDT , REAL 


The following snap points are available in VSAM. Each snap ID, if enabled 
with IKQVEDA, will produce the result indicated. If VSAM is running in 
the SVA, it must be reloaded from the core image library after the snap 
dump has been enabled in order to activate the snap, except for 
SNAP=0010 which takes effect immediately. 


Snap number 


0001 


0002 


0003 


0004 
0005 
0006 


0007 


0008 


0009 


0010 
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Result of Enabling this Snap 


This snap allows Catalog Management diagnostic informa- 
tion to be obtained. (See section ““Using UPSI to obtain 
Diagnostic Information for the VSAM Catalog” for de- 
tails.) 


As snap 0001 uses the UPSI byte, it cannot be run when the 
user program in the partition also uses the UPSI byte. 

This snap enables the Buffer Manager trace, which provides 
the current usage of VSAM buffering. 

This snap enables the CLOSE control block dump at the 
beginning of CLOSE processing. 

This snap enables the VSAM I/O trace facility. 

This snap enables the I/O error trace. 

This snap enables the OPEN control block dump facility 
when open processing is complete. 

This snap enables the OPEN error trace. Control blocks are 
printed if an error occurs during open processing. 


This snap enables the Catalog Management I/O trace. All 
I/O operations done by catalog management are printed on 
SYSLST. 


This snap enables the VSAM Record Management error 
handler trace, allowing display of control blocks for any 
error detected by VSAM record management. 

This snap enables automatic close. VSAM is shipped with 


this snap enabled. To disable automatic close, disable this 
snap. 
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0011 This support enables the managed-SAM control block 
trace. Refer to VSE/VSAM Space Management for SAM 
Feature Logic for further information. 


IKQVEDA is called by: 
// EXEC IKQVEDA 
The routine will print on SYSLOG: 
ENTER FUNCTION ENABLE|DISABLE| END 


You must enter either: 
ENABLE SNAP=xxxx 
(where xxxx is one of the snap numbers) 


or 
DISABLE SNAP=xxxx 
or 


END (to terminate processing). 
The program will look for a private core image library and print: 
NO PRIVATE CORE IMAGE LIBRARY ASSIGNED 


if it cannot be found and will then look in the core image library for the 
VSAM phase needed. 


If the phase needed cannot be found in a library the program will inform 
you with the following message: 

phase NOT FOUND IN THE SYSTEM PRIVATE 

CORE IMAGE LIBRARY (where phase is the actual phase name) 


Any error in input will result in the INVALID REPLY message and the 
ENTER FUNCTION message is reissued. 


Entering ENABLE SNAP=0011 in a system without the VSE/VSAM Space 
Management for SAM Feature installed results in an INVALID REPLY 
message. 


The program can only be ended by the END reply as noted earlier. 


The following examples illustrate the use of IKQVEDA to enable and 
disable SNAP 0001: 
// EXEC IKQVEDA 

ENTER FUNCTION ENABLE|DISABLE|END 
ENABLE SNAP=0001 
NO PRIVATE CORE IMAGE LIBRARY ASSIGNED 
SNAP 0001 ENABLED 
ENTER FUNCTION ENABLE|DISABLE| END 
DISABLE SNAP=0001 
NO PRIVATE CORE IMAGE LIBRARY ASSIGNED 
SNAP 0001 DISABLED 
ENTER FUNCTION ENABLE |DISABLE| END 
END 


Obtaining Snap Dumps of Control Blocks 
IKQVDUMFP enables you to print out snap dumps of record management 
and catalog control blocks. Code is provided at certain points in VSAM 
modules which is nonoperational so far as normal execution of the modules 
is concerned. Refer to “Enabling and Disabling Snap Dumps,” above. 
IKQVDUMP is called by the following sequence of instructions (see also 
“Loading a VSAM phase or a Program You Have Written’’): 
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LA 1,PARMLIST 


SVC 2 
PARMLIST DC CL8'$$BCVSO03' B transient 
DC CL8' IKQVDUMP phase that provides dump 


of control blocks 
When the program has completed processing, $$BCVS03 returns the pro- 
gram to the instruction immediately following the SVC instruction. 


Note that IKQVDUMP requires SYSLST to be assigned to a printer; 
assigment to disk or tape will result in an error. 


Figure 6.14 shows the description and format of the parameter list that f : 
follows the two phase names in the above calling sequence. . 
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Dec Hex 


Figure 6.14 
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Bit Pattern Field Name 


PARMSW1 
PARMAMBL 
PARMACB 
PARMAMDS 
PARMARDB 
PARMBCB 
PARMBUFE 
PARMEDB 
PARMLPMB 


PARMSW2 
PARMCCW 
PARMPLH 
PARMBHD 
PARMRPL 
PARMEXCP 
PARMCAT 
PARMDATA 
PARMTHB 


PARMSW3 
PARMOPEN 
PARMCLOS 
PARMCIW 
PARMVLST 
PARMREGS 
PARMCECL 


PARMODLB 
PARMREQR 


PARMSW4 
PARMPAMB 


PARMCCAA 


PARMRTNA 
PARMHDID 


PARMAMBA 
PARMID 
PARMIDLN 
PARMIDAD 


PARMSW5 
PARMCCA 
PARMCADL 
PARMCADP 
PARMCARA 
PARMCPL 
PARMPLDN 
PARMPLNN 
PARMPLPW 


Description 


First byte of parameter list 
Dump the AMBL 

Dump the ACB 

Dump the AMDSB 

Dump the ARDB 

Dump the BCB 

Dump the buffer 

Dump the EDB 

Dump the LPMB 


Second byte of parameter list 
Dump the CCW 

Dump the PLH 

Dump the BHD 

Dump the RPL 

Dump the EXCPAD work area 
Dump the catalog blocks 
Dump the non-catalog blocks 
Dump the THB 


Third byte of parameter list 

Dump the open work area 

Dump the close work area 

Dump the control interval split area 
Dump the volume list 

Dump the registers 

Dump the control interval exclusive 
control list 

Dump the open DLBL 

Dump the requester’s registers 


Fourth byte of parameter list 

1 =Pointer to start dump is in parameter 
list (PARMAMBA) 

O=Pointer to start dump is in register 11 
1=Pointer to CCA 

O=Pointer to AMBL 

Call the test routine 

Dump the header ID 

Available 


Pointer to start dump 
Pointer to header 
Length of the header 
Address of the ID 


Fifth byte of parameter list 

Dump the CCA 

Dump the CCA DLBL 

Dump the CCA DADSM parameter list 
Dump the CCA record areas 

Dump the catalog parameter list (CTGPL) 
Dump the CTGPL data set name 

Dump the CTGPL new name 

Dump the CTGPL password 
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Offset 
Dec Hex 


Bytes and 
Bit Pattern Field Name 


PARMSW6 
PARMPLCN 
PARMPLCI 
PARMPLDL 
PARMPLWA 
PARMCFL 


PARMFLFD 
PARMFLFN 


PARMSW7 
PARMCFV 


PARMFVDL 
PARMFVEN 
PARMFVKR 
PARMFVVL 
PARMDPDL 
PARMDPIO 


PARMDPWA 


PARMSW8 
PARMDPSV 


PARMCBS 
PARMCAXW 
PARMCXRL 


Description 


Sixth byte of parameter list 

Dump the CTGPL catalog name 

Dump the CTGPL control interval number 
Dump the CTGPL file CTGDDNM field 
Dump the CTGPL work area 

Dump the catalog field parameter list 
(CTGFL) 

Dump the CTGFL fields 

Dump the CTGEL field name 

Available 


Seventh byte of the parameter list 
Dump the catalog field vector table 
(CTGFV) 

Dump the CTGFV file name 

Dump the CTGFV entry name 

Dump the CTGFV key range list 
Dump the CTGFV volume serial list 
Dump the DADSM parameter list DLBL 
Dump the DADSM parameter list 1/O 
area is 

Dump the DADSM parameter list work 
area 


Eighth byte of parameter list 

Dump the DADSM parameter list save 
1/O area 

Dump the AMCBS 

Dump the CAXWA 

Dump the CAXWA RPL 


PARMCXDR Dump the CAXWA VTOC label read-in 
work area (DRWA) 

Dump the CMS work area 

Dump the managed-SAM control blocks. 


Available 
Name of test routine 


PARMCMSW 
PARMMSAM 





PARMRTNN 


Figure 6.14 IKQVDUMP parameter list description and format (part 2 of 2) 


Testing if a Dump is Required 
IKQVDUMP allows a phase to be called before a dump is taken to see if a 
dump is desired. (The name of the test routine must be inserted into the 
parameter list at field name PARMRTNN.) The phase can use any logic to 
determine whether a dump is needed, and this logic will override a call for a 
dump if it is not needed. Ifa 0 is returned in register 15, the dump will be 
taken; if register 15 holds a nonzero return, the dump will not be taken. 


The registers on entry to the test routine have the following contents: 


R2 = Pointer to the parameter list 
R11 = Caller’s register 11 

R13 = Pointer to 18-word save area 
R14 = Return address of calling phase 
R15 = Address of entry point 


Using UPSI to Obtain Diagnostic Information for the VSAM Catalog 
Manipulation of the UPSI job control statement enables you to screen 
catalog return codes and obtain a snap dump, cancel a job (which causes a 
full dump to be taken), or simply continue processing. You must first use 
IKQVEDA to enable Snap = 0001. Otherwise the UPSI statement will be 
inoperative. As snap 0001 uses the UPSI byte, it cannot be run when the 
user program in the partition also uses the UPSI byte. 
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The purpose of this service aid is to diagnose catalog errors that occur while 
running any program that causes the VSAM catalog to execute. Typically 
this would be an Access Method Services module or a record management 
program you have written. 


The // UPSI nnnnnnnn job control statement must precede the // EXEC 
[progname] statement. If no UPSI statement is included, the default is 
// UPSI 00000000 (see type 3 request below). 


On exit from catalog management after processing, a message will be print- 
ed out depending on the type of UPSI bit setting you have selected. Some 
messages require a reply from the operator. The return codes in the message 
are obtained from register 15. The format is: 


** NNN,MN,RRR,FFFF, cecececcecécecee 


where 
NNN is the return code in decimal. 


MN are the last two characters of the module name which issued the 
error. This is blank in case of error code 0. 


RRR is the reason code in decimal. 


FFFF is one of the following catalog management functions that had 
been processed: 


DEFC (define catalog) 

DEFA (define non-VSAM data set) 
DEFS (define space) 

DEF (define VSAM data set) 
ALT (alter) 

DELC (delete catalog) 

DELS (delete space) 

DEL (delete VSAM or non-VSAM data set) 
LSTC (list catalog) 

UPD (update or update-extend) 
LOC (locate) 


C...C is either the control interval number in decimal or the first 16 
characters of the data set name or volume serial number in EBCDIC. 


If a reply is required from the system operator for certain types of requests, 
the operator must enter one of the following replies from the system console: 


e Type in SNAP to get a snap dump by means of IKQVDUMP (see 
“IKQVEDA for enabling snap dumps’). The message will then be 
repeated and the operator should press the END key to continue proc- 
essing. 


¢ Type in CANCEL to cancel the job and obtain a full partition dump. 
e Press the END key to resume processing. 


The following paragraphs describe the four types of UPSI settings you can 
use to elicit a message and/or to determine the degree of return code screen- 
ing done: 


Type 1 UPSI Setting. If you want to obtain an operator message for all 
VSAM catalog return codes (including 0), you must include one of the 
following statements: 


// UPSI 11000000 Noreply is required from the operator 
// UPSI 01100000 A reply is required from the operator 
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Type 2 UPSI Setting. An operator message is issued only if the return code 
is not 0 for the following statements: 


// UPSI 10000000 Noreply is required from the operator 
// UPSI 01000000 A reply is required from the operator 


Type 3 UPSI Setting. An operator message is not issued if one of the follow- 
ing conditions exists: 


1, the Access Method Services command being processed was a LISTCAT 
and the return code is 8, or 

2. the return code is 0, 40, 68, or 160 

(These codes occur during normal processing and are, therefore, excluded). 

If neither of these conditions exists, an operator message is issued for the 

following statements: 

// UPSI 00000000 Noreply is required from the operator 

// UPSI 01110000 Noreply is required from the operator 


Type 4 UPSI Setting. If you want an operator message on a specific return 
code, you must include the following statements: 


// UPSI OOnnnnnn  nnnnnn is set to the value, in binary, of the code 
divided by 4. A reply is required from the operator 


Maintaining VTOC and VOLI Labels on DASD 
A VSAM DADSM service aid has been provided to assist the programmer 
and operator in maintaining the VTOC and VOL] labels on DASD devices. 


The following procedures should be followed to use IKQVDU at the system 
console for such maintenance. The key difference in the three procedures is 
the presence, or absence, of a // UPSI job control statement. Steps of the 
procedure in lower case letters are typed in at the console; steps in upper 
case letters are printed out. 
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Procedure 1 


// assgn sys000,x'cuu' 


(press END key) 


// upsi 1 
(press END key) 


// exec ikqvdu,size=auto 


(press END key) 


Procedure 2 


// assgn sys000,x'cuu' 


(press END key) 


// upsi 11 
(press END key) 


// exec ikqvdu,size=auto 


(press END key) 
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Explanation 


cuu points at the volume you want 
to use. | 


This job control statement is option- 
al. If it is included, the following 
events take place on the volume that 
was assigned to SYS000: 


e The VSAM volume ownership bit 
and CRA pointer in the F4 
VTOC label are reset. 


e The entire VTOC is scratched, 
that is, empty VTOC labels are 
written over existing Fl, F2, and 
F3 labels, with the exception of 
labels that have names starting 
with the characters “DOS.” or 
“PAGE”. 

e An operator authorization 
prompt is issued if the VTOC la- 


bel to be scratched is security 
protected. 


Start execution of the IKQVDU 
phase 


Explanation 


cuu points at the volume you want 
to use. 


This job control statement is option- 
al. If it is included, the following 
events take place on the volume that 
was assigned to SYS000: 

¢ The VSAM volume ownership bit 
and CRA pointer in the F4 label 
are reset. 

e The entire VTOC is scratched, 
that is, FO labels are written over 
existing Fl, F2, and F3 labels, 
with the exception of labels that 
have names starting with the 
characters “DOS.” or “PAGE”. 


Start execution of the IKQVDU 
phase. 
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Procedure 3 Explanation 


// assgn sys000,x'cuu' cuu points at the volume you want 
(press END key) to use. 

// exec ikqvdu,size=30k Start execution of the IKQVDU 
(press END key) phase. 

SPECIFY FUNCTION OR REPLY The character ? causes a list of the 


'?' FOR OPTIONS READY 
) 


(press END key) 


various functions that IKQVDU 
performs to be printed out at the 
system console. 


TO SET THE VOLUME OWNERSHIP FLAG REPLY 'SET OWNERSHIP' 

TO SET THE CRA POINTER REPLY 'SET OWNERSHIP' 

TO RESET THE VOLUME OWNERSHIP FLAG AND CRA POINTER REPLY 
"RESET OWNERSHIP' OR 'RESET CRA' ; 

TO SET THE SECURITY FLAG IN A F1 LABEL REPLY 'SET 
SECURITY' 

TO RESET THE SECURITY FLAG IN A F1 LABEL REPLY 'RESET 
SECURITY' 

TO REMOVE A LABEL FROM THE VTOC REPLY 'SCRATCH' 

TO RENAME A LABEL REPLY 'RENAME' 

TO ALLOCATE A LABEL REPLY 'ALLOCATE' 

TO REINITIATE PROCESSING REPLY 'RESTART' 

TO ALTER OR DISPLAY A DASD VOL1 LABEL 

REPLY 'CLIP LABEL=SER=N..N' OR 'CLIP LABEL=DISPLAY' 

TO TERMINATE PROCESSING REPLY 'END' 


READY 


You can avoid printing out this list of functions simply by specifying the function 
you wish as follows: 


Procedure Explanation 
set ownership Causes the VSAM ownership bit to 
(press END key) be set in the F4 VTOC label and op- 
tionally allows the user to set the 
CRA pointer. 
BESS RON GE Causes the VSAM ownership bit 
reset ownership and CRA pointer to be reset in the 
F4 VTOC label. 
set security Causes the security bit to be set in 
(press END key) the Fl VTOC label. 


When the console responds with 
ENTER DSN, reply with the data 
set name of the VTOC label to be 


modified. 
reset security Causes the security bit in the F1 la- 
(press END key) bel to be reset. 


When the console responds with 
ENTER DSN, reply with the data 
set name of the VTOC label to be 


modified. 
scratch dsn=dsname Causes the VTOC label with the 
(press END key) specified data set name to be 
scratched. 
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scratch vtoc 


(press END key) 


rename 


(press END key) 


allocate 


(press END key) 


restart 
(press END key) 


clip label=display 
(press END key) 


clip label=ser=n..n 


(press END key) 
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Causes the entire VTOC to be 
scratched with the exception of data 
set names starting with the charac- 
ters “DOS.” and “PAGE”. In addi- 
tion, an operator-authorization 
prompt will be issued if the VTOC 
label is security-protected or de- 
scribes a catalog. 


Causes the DSNAME portion of the 
Fl VTOC label to be changed. 


When the console responds with 
ENTER OLD DSN, reply with the 
data set name of the VTOC label to 
be changed. Be sure to enter the 
correct OLD DSN. No error check- 
ing is performed in case an invalid 
name is specified. 


When the console responds with 
ENTER NEW DSN, reply with the 
new data set name. 


Causes a new label to be created and 
written in the VTOC. In order to 
utilize this function, a 
DLBL/EXTENT job control state- 
ment must be provided. 

When the console responds with 
ENTER FILENAME, reply with 
the same filename as that in the 
DLBL statement referred to above. 


When the console responds with 


ENTER NEW DSN, reply with the 
data set name of the data set to be 
created. 


When the console responds with DO 
YOU WISH TO SECURITY PRO- 
TECT THIS DATA SET? reply 
YES or NO. A reply of YES causes 
the data security bit to be set in the 
Fl VTOC label. A reply of NO 
causes the data security bit to be re- 
set. 


Causes processing to be reinitiated 
with a READY prompt. This key- 
word can be used as a response to 
any operator prompt. 


Causes the volume serial number to 
be displayed on the system console. 


Causes the existing volume serial 
number to be changed to the one 
specified as n..n. 
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end Causes processing to terminate. 
(press END key) 


If an error occurs during execution of IKQVDU, 
**ERROR** DADSM RETURN CODE IS nnn 


prints out on the system console. The following shows the message code 
(nnn), the associated message, and the action required to correct the condi- 
tion. 


Example: 
*#* ERROR** DADSM RETURN CODE IS 020 VTOC FULL 


004 1/O ERROR WHILE READING VOLUME LABEL 
Action: if the problem was not caused by a hardware error, restore the 
volume. 


008 VOLUME NOT MOUNTED 
Action: Mount the correct volume. 


012 I/O ERROR ON VTOC 
Action: If the problem was not caused by a hardware error, restore the 
volume. 


016 DUPLICATE NAME ON VOLUME 
Action: Choose another filename or scratch the original file from the 
volume. If duplication is due to key ranges, ensure each UNIQUE key 
range is on a separate volume. 


020 VTOC FULL 
Action: Delete any non-VSAM files or VSAM data spaces no longer 
needed from the volume to make additional Format | labels available, 
or reinitialize the volume with a larger VTOC. 

024 EXTENT OVERLAPS EXPIRED FILE 
Action: Examine the VTOC listing to determine where the overlap 
occurred. Correct the EXTENT statement causing the error. To delete 
the expired file, open a DTF using the same file-ID as that of the — 


expired file, and instruct the operator to reply DELETE to message _-__. -- 


4n33A when it is issued. 


028 EXTENT OVERLAPS UNEXPIRED FILE 
Action: Compare the high and low extent limits on the EXTENT .. 
statement or LSERV output with the file or data space limits on the 
VTOC display. If the extents overlap, correct the EXTENT statement 
in error. 


032 EXTENT OVERLAPS PROTECTED UNEXPIRED FILE 
Action: Examine the VTOC to determine where the overlap occurred. 
Correct the EXTENT statement causing the error. If necessary, use 
another volume. 


036 EXTENT OVERLAPS VTOC 
Action: Execute LVTOC. The Format 4 label (the first label in the 
VTOC display) contains the extent limits of the VTOC. If the program 
being executed uses a temporary label set and overlaps the VTOC, 
correct the EXTENT statements that overlap. If the job uses standard 
or partition standard labels, use the LSERV output to correct the 
extents of the overlapping file, VSAM data space, or UNIQUE VSAM 
file. Then rebuild the appropriate label tracks. 
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040 REQUIRED EXTENTS MISSING 
Action: If temporary labels were used, match the extents on the 
incoming EXTENT card with the extents in the LVTOC output. If 
standard (permanent) labels were used, match the extents in the 
LSERV output with those in the LVTOC output. 


044 LABEL NOT FOUND 
Action: Use the LVTOC output to check for all file labels used in 
OPEN macros. If the file has been destroyed, it was probably due to 
deletion of overlapping extents on an unexpired file, and the file must 
be rebuilt. 


048 INVALID LABEL ADDRESS 
Action: Examine the VTOC for a label having an invalid forward 
chain pointer, and delete it. If no invalid labels are found, just rerun 
the job. 


056 EXTENT OVERLAPS PROTECTED EXPIRED FILE 
Action: Examine the VTOC listing to determine where the overlap 
occurred. Correct the EXTENT statement causing the error. If it is 
not necessary to save the expired file, open a DTF using the same 
file-ID as that of the expired file, and instruct the operator to reply 
DELETE to message 4n33A when it is issued. 

064 GETVIS FAILURE ENCOUNTERED 
Action: Allocate GETVIS area. If VSAM is running in the SVA, 
re-IPL and specify a new value for SET SVA. If VSAM is running ina 
partition, rerun the job in a larger partition. 

072 CDLOAD FAILURE ENCOUNTERED 
Action: Either the CDLOAD directory or the GETVIS area is full. 
Allocate more space. 

080 OVERLAP AMONG NEW EXTENTS 
Action: If DLBL and EXTENT statements are included in the pro- 
gram, determine the conflicting extents and correct them. Ifa standard 
label set is being used, use the LSERV output to locate and correct the 
conflicting file extents, and rebuild the standard label tracks. 

088 FORMAT 4 LABEL NOT FOUND 
Action: Reinitialize the VTOC to create a format-4 label. 

092 VOL! LABEL NOT FOUND 
Action: Reinitialize the volume to create a VOLI label. 

096 JIB PROCESSING FAILURE 
Action: Rerun the job when more JIBs are available. 


Loading a VSAM Phase or a Program You Have Written 


If you want to load and transfer control to and from a selected VSAM phase 
or a program you have written, you can use B-transient $$BCVS03 without 
destroying any registers in the following calling sequence: 
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LA 1,PARMLIST 
svc 2 


PARMLIST DC CL8'$$BCVSO3' B transient 
RTNNAME Dc CL8'XXXXXXxx' Name of phase or program 
you have written 
USERLIST DC Parameter list for phase 
, "XXXXXXXxX' 


When control is received by ‘KXXXXXXX’, the registers have the following 


contents: 
RO = Address of a work area (the size of the work area is specified 
by a halfword at offset 4 of “‘XXXXXXXX’ phase) 
R1 = Pointer to user’s parameter list (USERLIST) 
R2-13 = Remain the same as they were when SVC 2 was issued 
R14 = = Return address of calling module 
RIS == Address of entry point in ‘XXXXXXXX’ 


Control is returned from ‘XXXXXXXX’ by a BR 14 instruction. 
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Definitions of Terms Used In This Book 


Access Method Services. A multifunction service program 
that defines VSAM data sets and allocates space for them, con- 
verts indexed sequential data sets to key-sequenced data sets 
with indexes, modified data-set attributes in the catalog, recog- 
nizes data sets, facilitates data portability between operating 
systems, creates backup copies of data sets and indexes, helps 
make inaccessible data sets accessible, and lists data-set records 
and catalog entries. 


address direct access. The retrieval or storage of a data re- 
cord identified by its RBA (relative byte address) independent 
of the record’s location relative to the previously retrieved or 
stored record. (See also keyed direct access, addressed sequen- 
tial access, and keyed sequential access.) 


addressed sequential access. The retrieval or storage of a 
data record in its entry (RBA) sequence relative to the previous- 
ly retrieved or stored record. (See also keyed sequential access, 
addressed direct access, and keyed direct access.) 


allocation chain (AC). All allocation units containing control 
blocks for the same ACB. 


allocation unit (AU). One or more pages of virtual storage 
containing control blocks referenced by record management. 


alternate index. A collection of index entries, related to a give 
base cluster and organized by a key other than the prime key of 
the associated base data records. Its function is to provide an 
alternate means of locating records in the data portion of the 
base cluster. 


alternate index upgrade. The process of reflecting changes 
made to a base cluster in its associated alternate index(es). (See 
also upgrade set.) 


alternate key. A key, other than the prime key, used to form 
an alternate index. 


application. As used in this publication, the use to which an 
access method is put or the end result that it serves; contrasted to 
the internal operation of the access method. 


backward processing. A variation of sequential processing, 
whereby the previous, rather than the next, record in the entry, 
key; or relative-record sequence is retrieved. 


base catalog record. The first catalog record (control interval) 
that describes the VSAM object. This record contains the 
object’s data set name, cluster name, or volume serial number in 
the ENTNAME field. This record also contains the header 
fields required for the object. The base catalog record ¢an con- 
tain group occurrence pointers that point to group occurrences 
in the base catalog record, or that point to group occurrences in 
extension records (vertical extension). The base catalog record’s 
extension pointer can point to a control interval that continues 
the information (group occurrence pointers) contained in the 
base catalog record (horizontal extension). 


base cluster. A key-sequenced or entry-sequenced data set 
over which one or more alternate indexes are built. 
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Glossary 


candidate volume. A direct-access storage volume that has 
been defined in a VSAM catalog asa VSAM volume; VSAM 
can automatically allocate space on this volume, as needed. (See 
also overflow volume.) , 


catalog. (See VSAM catalog.) 


cluster. A combination of related VSAM data sets, identified 
by one name in the VSAM catalog, that is, a key-sequenced data 
set and its index or an entry-sequenced data set alone. 


collating sequence. An ordering assigned to a set of items, 
such that any two sets in that assigned order can be collated. As 
used in this publication, the order defined by the System/370 
8-bit code for alphabetic, numeric, and special characters. 


component. As used in this manual, a group of modules that 
perform a function, such as Open. 


compression. (See key compression.) 


control area. A group of control intervals used as a unit for 
formatting a data set before adding records to it. Also, ina 
key-sequenced data set, the set of control intervals pointed to by 
a sequence-set index record; used by VSAM for distributing free 
space and for placing a sequence-set index record adjacent to its 
data. 


control-area split. The movement of the contents of some of 
the control intervals in a control area to a newly created control 
area, to facilitate the insertion or lengthening of a data record 
when there are no remaining free control intervals in the origi- 
nal control area, 


controlinterval. A fixed-length area of direct-access storage 
in which VSAM stores records and distributes free space. It is 
the unit of information transmitted to or from direct-access 
storage by VSAM, independent of blocksize. 


control interval access. The retrieval or storage of the con- 
tents of a control interval. 


control-interval split. The movement of some of the stored 
records in a control interval to a free control interval, to facili- 
tate the insertion or lengthening of a record that won’t fit in the 
original control interval. 


CRA. Catalog recovery area. An entry-sequenced data set 
which exists on each volume owned by a recoverable catalog, 
including the catalog volume itself. The CRA contains records 
which describe the volume and the data sets on the volume. 


data integrity. Preservation of data or programs for their 
intended purpose. As used in this publication, the safety of data 
from inadvertent destruction or alteration. 


datarecord. A collection of items of information from the 
standpoint of its use in an application and not from the stand- 
point of the manner in which it is stored (see also stored record). 


data security. Prevention of access to or use of data or pro- 
grams without authorization. As used in this publication, the 
safety of data from unauthorized use, theft, or purposeful de- 
struction. 


Glossary 7A 


dataset. The major unit of data storage and retrieval in the 
operating system, consisting of data in a prescribed arrangement 
and described by control information to which the system has 
access. As used in this publication, a collection of fixed- or 
variable-length records in direct-access storage, arranged by 
VSAM in key sequence or in entry sequence. (See also key- 
sequenced data set and entry-sequenced data set.) 


data space. A storage area defined in the volume table of 
contents of a direct-access volume for the exclusive use of 
VSAM to store data sets, indexes, and catalogs. 


direct access. The retrieval or storage of data by a reference to 
its location in a data set rather than relative to the previously 
retrieved or stored data. Direct access is equivalent to ISAM 
random access. (See also addressed direct access and keyed 
direct access.) 


distributed free space. Space reserved within the control 
intervals of a key-sequenced data set for inserting new records 
into the data set in key sequence; also, whole control intervals 
reserved in a control area for the same purpose. 


dynamic storage area (DSA). A block of storage set aside on 
entry to open/close which may be suballocated to provide for 
temporary storage requirements of individual modules. 


entry-sequence. The order in which data records are physical- 
ly arranged in direct-access storage, without respect to their 
contents. (Contrast to key sequence.) 


entry-sequenced data set. A data set whose records are loaded 
without respect to their contents, and whose relative byte ad- 
dresses cannot change. Records are retrieved and stored by 
addressed access, and new records are added at the end of the 
data set. 


exclusive control. (See hold.) 


extension record. The continuation of a catalog record that 
contains group occurrence pointers and their group occurrences. 
Group occurrence pointers in an extension record always point 
to group occurrences within the extension record. The extension 
record’s extension pointer can point to a control interval that 
contains part of a group occurrence too large to fit in the exten- 
sion record (horizontal extension). 


extent. A continuous space allocated on a direct-access storage 
volume, reserved for a particular data space or data set. 


external procedure. A procedure that can be called by any 
other VSAM procedure; a procedure whose name is in the 
module’s (assembler listing) ‘external symbol dictionary.” 


field. Ina record or a control block, a specified area used for a 
particular category of data or control information. 


file. (See data set.) 


fixed block architecture (FBA). A direct access storage device 
that supports a fixed, 512-byte physical record size. The count- 
erpart, count-key-data (CKD) device, permits variable record 
sizes. 


free space. (See distributed free space.) 


free space percentage. (See packing factor.) 
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generic key. A high-order portion of a key, containing charac- 
ters that identify those records that are significant for a certain 
application. For example, it might be desirable to retrieve all 
records whose keys begin with the generic key AB, regardless of 
the full key values. 


groupcode. A code that identifies the type of group occur- 
rence. (See Field Name Dictionary for a list of group codes.) 


group occurrence. Related fields of information in catalog 
records. See “Group Occurrences in Catalog Records” in the 
“Data Areas” section for further details. 


group occurrence pointer. A field used to identify and locate 
a group occurrence by its displacement from the beginning of 
the record’s group occurrences (the group occurrence is in the 
same control interval as the group occurrence pointer) or by a 
control interval number (the group occurrence point is in the 
base catalog record or its extension and the group occurrence is 
in an extension record). Group occurrence pointers are grouped 
by type code and are in ascending sequence by sequence num- 
ber. 


high-used RBA. The next byte past the end of the last control 
interval containing significant data, for ESDA; otherwise, the 
RBA at which the last SEOF is written. 


high-water RBA. The high-used RBA of a data set. 


hold. Exclusive control exercised over data or index during an 
update, erase, or insert operation to prevent another request 
from making interim changes between initiation and completion 
of the original request. 


horizontal extension. An extension record pointed to by a 
catalog record’s extension field. (See also vertical extension.) 


horizontal pointer. A pointer in a sequence set index record 
that gives the location of the next index record in the same 
sequence set; used for keyed sequential access. 


index. As used in this publication, an ordered collection of 
pairs, each consisting of a key and a pointer, used by VSAM to 
sequence and locate the records of a key-sequenced data set; 
organized in levels of index records. (See also index level, index 
set and sequence set.) 


index entry. A key and a pointer paired together, where the 
key is the highest key (in compressed form) entered in an index 
record in the next lower level or contained in a data record ina 
control interval, and the pointer gives the location of that index 
record or control interval.. 


index level. A set of incex records that order and give the 
location of records in the next lower level or of control intervals 
in the data set that it controls. 


index record. A collection of index entries that are retrieved 
and stored as a group. (Contrast to data record.) 


index replication. The use of an entire track of direct-access 
storage to contain as many copies of a single index record as 
possible; reduces rotational delay. 


index set. The set of index levels above the sequence set. The 
index set and the sequence set together comprise the index. 


integrity. (See data integrity.) 
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internal procedure. A procedure that can be called only by 
another procedure within the module. (See also external proce- 
dure.) 


I/O threshold. The maximum number of buffers that can be 
filled with data before I/O will be started. 


ISAM interface. A set of routines that allow a processing 
program coded to use ISAM (Indexed Sequential Access Me- 
thod) to gain access to a VSAM key-sequenced data set. 


job catalog. A catalog made available for a job by means of 
the filename IJSYSUC in the corresponding DLBL job state- 
ment. 


key. One or more characters within an item of data that are 
used to identify it or control its use. As used in this publication, 
one or more consecutive characters taken from a data record, 
used to identify the record and establish its order with respect to 
other records. (See also key field and generic key.) 


key compression. The elimination of characters from the front 
and the back of a key that VSAM does not need to distinguish 
the key from the preceding or following key in an index record; 
reduces storage space for an index. 


key-field. A field located in the same position in each record of 
a data set, whose contents are used for the key of the record. 


key-sequence. The collating sequence of data records, deter- 
mined by the value of the key field in each of the data records. 
May be the same as, or different from, the entry sequence of the 
records. 


key-sequenced data set. A data set whose records are loaded 
in key sequence and controlled by an index. Records are re- 
trieved and stored by keyed access or by addressed access, and 
new records are inserted in the data set in key sequence by 
means of distributed free space. Relative byte addresses of 
records can change. 


keyed direct access, The retrieval or storage of a data record 
by use of either an index that related the record’s key to its 
relative location in the data set, or a relative-record number, 
independent of the record’s location relative to the previously 
retrieved or stored record. (See also addressed direct access, 
keyed sequential access, and addressed sequential access.) 


keyed sequential access. The retrieval or storage of a data 
record in its key or relative-record sequence relative to the previ- 
ously retrieved or stored record, as defined by the sequence set 
of an index. (See also addressed sequential access, keyed direct 
access, and addressed direct access.) 


LOCK wait. A wait for the release of a named resource that is 
locked by another VSE task, using the LOCK macro. 


mass sequential insertion. A technique VSAM uses for keyed 
sequential insertion of two or more records in sequence into a 
collating position in a data set; more efficient than inserting 
each record directly. 


master catalog. The main VSAM catalog, that contains exten- 
sive data set and volume information required by VSAM to be 
able to locate data sets to allocate and deallocate storage space, 
to verify the authorization of a program or operator to gain 
access to a data set, and to accumulate usage statistics. (See also 
job catalog, user catalog.) 
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max-CA. A unit of allocation equivalent to the maximum 
control area size on a count-key-data or fixed block device. On a 
CKD device, the max-CA is equal to one cylinder. 


min-CA. A unit of allocation equivalent to the minimum con- 
trol area size on a count-key-data or fixed block device. Ona 
CKD device, the min-CA is equal to one track. 


module. As used in this manual, a program unit that is identifi- 
able by means of a symbolic name starting with IGGO or IKQ. 


nonunique. Space for a nonunique data set or index must be a 
suballocation from existing data spaces. 


object. As used in this manual, a cluster, a data set, an index, a 
catalog, or a data space. 


overflow volume. When space on a candidate volume is allo- 
cated by VSAM, that volume is then termed an overflow vol- 
ume. (See also candidate volume.) 


overlapped operation. An operation in which processing 
continues without waiting for completion of input or output 
which had been initiated. 


packing factor. Percentage of the data object’s space alloca- 
tion to be reserved during its initial loading and during subse- 
quent reorganization. (See also distributed free space.) 


password. A unique string of characters stored in a catalog 
that a program, a computer operator, or a terminal user must 
supply to meet security requirements before a program gains 
access to a data set. 


physical record. The smallest readable or writable unit of data 
that is stored on a direct-access storage device. Records are 
separated from each other by interrecord gaps. 


pointer. An address or other indication of location. For exam- 
ple, an RBA is a pointer that gives the relative location of a data 
record or a control interval in the data set to which it belongs. 
(See also horizontal pointer and vertical pointer.) 


portability. The ability to use VSAM data sets with different 
operating systems. Volumes whose data sets are cataloged ina 
user catalog can be demounted from storage devices of one 
system, moved to another system, and mounted on storage 
devices of that system. Individual data sets can be transported 
between operating systems using Access Method Services. 


prime index. The index of a key-sequenced data set which is a 
base cluster, and thus has one or more alternate indexes. (See 
also index, alternate index.) 


prime key. The key which is used to form the prime index. 
(See also key, alternate key.) 


procedure. A functional unit of VSAM code that is entered 
only at one entry point and exits at the end of the procedure (the 
last line of the procedure’s code). The procedure can call 
(transfer control, with a return to the procedure expected) other 
procedures within the module (internal calls) and can call other 
procedures in other VSAM modules (external calls). (See also 
internal procedure and external procedure.) 


pseudo hold. For SHAREOPTIONS(4), a second hold on the 
same control area by a single VSE task, under a single ACB (or 
both hold requests under the same Local Shared Resource pool). 
The control area is treated as held by the second request, as well 
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as the first. If the second request encounters an actual confilct 
with the first request, then the second request will receive an 
“exclusive control conflict” return code (X‘08’ in register 15, 
X‘14 in the RPL feedback). 


random access. (See direct access.) 


RBA. Relative byte address. The displacement of a data rcord 
or a control interval from the beginning of the data set to which 
it belongs; independent of the manner in which the data set is 
stored. . 


record. (See index record, data record, physical record, stored 
record.) 


recoverable catalog. A catalog defined with the recoverable 
attribute. Duplicate catalog entries are stored in CRAs, and can 
be used to recover data in the event of a catalog failure. (See 
also CRA.) 


recovery mode. A user option that causes the data object’s 
initial allocation of space to be written throughout with special 
records, the last of which is set to 0 and is termed the SEOF 
(software end of file) record. This must be done if VERIFY is to 
be used. (See also speed mode.) 


relative byte address. (See RBA.) 


relative-record dataset. A data set whose records are loaded 
into fixed-length slots and numbered by the relative numbers of 
the slots they occupy. 


relative-record number. A number that identifies not only the 
slot, or data space, in a relative-record data set but also the 
record occupying the slot. Used as a key for keyed access to a 
relative-record data set. 


relative repetition number. An integer representing the posi- 
tion of a particular field in a group of repeating fields. For 
example, in EOV, the relative repetition number (RELREPNO) 
of a particular volume in the catalog data record of a particular 
cluster is that number of its occurrence in the volume repeating 
group. EOV uses the RELREPNO to obtain information about 
a particular volume in order to update the ARDB and EDB. 


replication. (See index replication.) 


reusable data set. A VSAM data set which can be reused as a 
work data set, regardless of its old contents. 


routine. As used in this manual, an ordered set of instructions 
that may have frequent use, generally internal usage within a 
module. 


scratch (adj.). Used to describe the contents of a buffer that 
are no longer valid. 


scratch (v.). In buffer management, used to indicate that a 
buffer contains nothing of significance; in DADSM, to remove a 
DSCB. 


section. A subdivision of an index record used to expedite 
location of the place in an index record where an entry-by-entry 
key search can begin. 


security. (See data security.) 


SEOF. (See software end of file.) 
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sequence set. The lowest level of the index of a key-sequenced 
data set; it gives the locations of the control intervals in the data 
set and orders them by the key sequence of the data records they 
contain. The sequence set and the index set together comprise 
the index. 


sequential access. The retrieval or storage of a data record in 
either its entry sequence, its key sequence, or its relative-record 
number sequence relative to the previously retrieved or stored 
record. (See also addressed sequential access and keyed sequen- 
tial access.) 


skip sequential access. Keyed sequential retrieval or storage 
of records in ascending, non-consecutive sequence (with skips); 
VSAM scans the sequence set to find a record or a collating 
position. 


slot. A fixed-length, numbered space in a relative-record data 
set which accepts one data record. (See also relative-record data 
set, relative-record number.) 


software end of file. A control interval with a CIDF of 0 that 
marks the end of preformatted records in a data object’s initial 
allocation of space when the user specifies recovery mode of 
processing. (See also recovery mode.) 


spanned record. A logical record whose length exceeds the 
control interval size and thus crosses, or spans, one or more 
control interval boundaries within a single control area. 


stored record. A data record, together with its control inform- 
ation, as stored in a direct-access storage device. 


string. A string is a single record or a sequentially ordered set 
of records in a data set. The maximum number of strings 
(STRNO) to be processed concurrently in a data set is estab- 
lished when a data set is opened. The number of active RPLs 
determines the number of concurrent strings being processed at 
any point in time. 


string-set. Set of strings that are in communication with each 
other. For normal processing, this is the set of active RPLs 
referring to the same ACB. For Local Shared Resources, this is 
the set of all active RPLs using the Local Shared Resource pool. 


unique. (1) A unique data space is occuplied by only one 
VSAM data set, and cannot be shared with other data sets. (2) A 
unique alternate key is one which occurs in only one data record 
in the base cluster. The alternate index record containing this 
key thus has only one pointer to the base cluster. 


upgrade set. All the alternate indexes that VSAM has been 
instructed to update whenever there is a change to the data of 
the related base cluster. 


user catalog. An optional catalog used in the same way as the 
master catalog and pointed to by the master catalog. It lessens 
the contention for the master catalog and facilitates volume 
portability. 


vertical extension. An extension record pointed to by a group 
occurrence pointer in the object’s base catalog record or its 
horizontal extension. (See also base catalog record and horizon- 
tal extension.) 


vertical pointer. A pointer in an index record of a given level 
that gives the location of an index record in the next lower level 
or the location of a contro! interval in the data set controlled by 
the index. 
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VSAM catalog. A key-sequenced data set containing exten- data set, and to accumulate usage statistics for data sets. (See 
sive data-set and volume information that VSAM requires to also master catalog, job catalog, user catalog.) 

locate data sets, to allocate and deallocate storage space, to 

verify authorization of a program or operator to gain access to a 


—_ 
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This index lists the modules by their descriptive 
names, followed by their symbolic names. The 
symbolic names, together with further information 
about the modules, can be found in the module 
directory in the Directory chapter. 


$$B message routine (IIPBMRO00) 4.11 


abbreviations xiv 
ACB (Access Method Control Block) 5.64 
Access Method Block List (AMBL) 5.70 
Access Method Control Block (ACB) 5.64 
Access Method Control Block Structure (AMCBS) 5.73 
Access Method Data Statistics Block (AMDSB) 5.73 
Access Method Define the File Table (AMDTF) 5.78 
acronyms xiv 
add group occurrence (modify) (IGGOCLAW) 4.9 
Address Range Definition Block (ARDB) Vol. 2 
AIX (see alternate index) 
allocate data spaces (IKQALLO00) 4.11 
alter 
catalog field IGGOCLAX) 4.9 
catalog, remove volume processing (IGGOCLBN) 4.9 
CMS, 4th module (IGGOCLCD) 4.10 
processing, catalog (IGGOCLBD) 4.9 
volume processing (IGGOCLBE) 4.9 
alternate index (AIX) 
base cluster control block structure Vol. 2 
catalog record 5.27 
clean up (IKQCLOCL) 4.12 
define (IGGOCLCA) 4.10 
delete (IGGOCLBG) 4.9 
description 5.10 
evaluation (IKQCLOVY) 4.12 
record 5.10 
routine (IKQAIX) Vol. 2 
Upgrade routine (IKQUPG) Vol. 2 
upgrade set determination (IDQOPNUS) 4.12 
alternate index initialization (IKQOPNAI) 4.12 
AMBL (Access Method Block List) 5.70 
AMCBS (Access Method Control Block Structure) 5.73 
AMDSSB (Access Method Data Statistics Block) 5.73 
AMDSB group occurrence 5.42 
AMDTF (Access Method Define the File table) 5.78 
AMDTE control block (IIPAMT00) 4.11 
ARDB (Address Range Definition Block) Vol. 2 
association group occurrence 5.43 
attach data set to Resource Pool (IKQOPNRP) 4.12 
authorization, check (IGGOCLBM) 4.9 
automatic close ($§BACLOS) 4.13 


base cluster to alternate index control 
block structure Vol. 2 
BCB (Buffer Control Block) Vol. 2 
BHD (Buffer Header) Vol. 2 
bit mask handler, suballocate (IGGOCLBR) 4.9 
BKPHD (Block Pool Header) Vol. 2 
BLDVRP (IQKBRP) 4.11 
BLDVRP Parameter List (BVRPPL) 5.81 
block dump (IKQDUMP) 4.12 
Block Pool Header (BKPHD) Vol. 2 
block-to-track translation (IGGOCLEX) 4.11 
BSPH (Buffer Subpool Header) Vol. 2 
buffer management Vol. 2 
buffer 

control block (BCB) Vol. 2 

do I/O (IKQBFA) Vol. 2 

FREEBUFF (IKQBFA) Vol. 2 
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get next (IKQGNX00) Vol. 2 
GETBUFF (IKQBFA) Vol. 2 
header (BHD) Vol. 2 
manager (IKQBFA00) Vol. 2 
manager, LSR (IKQBFB) Vol. 2 
purge (IKQPBF) Vol. 2 
read-ahead (IKQBFA) Vol. 2 
scratch buffer (IKQBFA) Vol. 2 
scratch buffer (IKQBFB) Vol. 2 
subpool header (BSPH) Vol. 2 
writing (IKQBFB) Vol. 2 
build AMDSB (IKQOPNAB) 4.12 
build 
a new control block-GENCB (IKQGEN) 4.12 
JIB ($$BOVS03) Vol. 2 
RDF (IKQBLD) Vol. 2 
VSAM Resource Pool-BLDVRP (IKQBRP) 4.11 
VTOC labels (IKQPOP00) 4.12 
BVRPPL (BLDVRP Parameter List) 5.81 


catalog I/O subfunctions (IGGOCLEG) 4.10 
catalog 
alter 
processing (IGGOCLBD) 4.9 
remove volume processing (IGGOCLBN) 4.9 
auxiliary work area (CAXWA) 5.82 
communications area (CCA) 5.84 
control blocks, dump (IKQDUMPC) 4.12 
control record (CCR) 5.28 
define space (IGGOCLAQ) 4.8 
definition processing (IGGOCLAS) 4.8 
delete (IGGOCLAF) 4.8 
description 5.11 
dictionary 5.52 
display (IKQSCAT) 4.13 
driver (IGGOCLAB) 4.8 
field 
alter (IGGOCLAX) 4.9 
extract (IGGOCLAZ) 4.9 
modify (IGGOCLAV) 4.9 
first load (IGGOCLC9) 4.10 
high key range of 5.13 
I/O subfunctions (IGGOCLAG) 4.8 
I/O subroutine, 2nd load (IGGOCLCG) 4.10 
locate (IGGOCLAZ) 4.9 
low key range of 5.13 
modify (IGGOCLAV) 4.9 
parameter list (CTGPL) 5.99 
parts of (figure) 5.12 
read/write F4 VTOC label (IGGOCLBU) 4.10 
records (see catalog records) 
recovery area (see catalog recovery area) 
search (IGGOCLAH) 4.8 
self-describing part of 5.12 
SHOWCAT (IKQSCAT) 4.13 
suballocate (IGGOCLAR) 4.8 
update (IGGOCLAV) 4.9 
update (IKQRBA) 4.12 
update for sharing (IKQRBA) 4.12 
update-extend (IGGOCLBB) 4.9 
user 
description 5.11 
module (IKQOPNUC) 4.12 
catalog management overview 3.9, 5.62 
catalog management procedures cross reference 6.38 
catalog records 
copies of in CRA 5.15 
formats 5.16 
group occurrences in 
(see group occurrences) 
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retrieve (IGGOCLAH) 4.8 
types 5.12 
catalog recovery area (CRA) 
copies of catalog records in 5.15 
define 
Ist module (IGGOCLCR) 4.10 
2nd module (IGGOCLCS) 4.10 
description 5.14 
open (IGGOCLCD) 4.10 
self describing part of 5.14 
catalog/DASDM interface to mount 
volume ($$BOVS01) 4.13 
CAXWA (Catalog Auxiliary Work Area) 5.82 
CCA (Catalog Communication Area) 5.84 
save area 6.19 
CCB (Command Control Block) (see IORB) Vol. 2 
CCW (Channel Command Word) Vol. 2 
CCW Skeleton DSECT (CWS) Vol. 2 
CCW Skeletons Vol. 2 
Channel Command Word (CCW) Vol. 2 
check authorization (IGGOCLBM) 4.9 
CI split duplicate data recovery (IKQDDR) Vol. 2 
CI split for load mode (IKQCIL) Vol. 2 
CI split for non-load (IKQCIU) Vol. 2 
CIDF (Control Interval Definition Field) 5.2 
CILOAD (IKQCIS00) 4.11 
CINSRT (IKQCIS00) 4.11 
CINTRY (IKQCIS00) 4.11 — 
CISPL2 (IKQCIS00) 4.11 
CIW (Control Interval Work Area) Vol. 2 
clean up 
after open failure (IKQOPNDO) 4.12 
alternate index (IKQCLOCL) 4.12 
define (IGGOCLA8) 4.9 
CLOSE 3.13 
close 
automatic ($$BACLOS) 4.13 
catalog interface function (IKQCLCAT) 4.11 
disposition processing IKQCLRDD) 4.12 
function (IKQCLO) 4.12 
interface ($$BCVSAM) 4.13 
ISAM interface program (IIPCLS00) 4.11 
record management (IKQRCLO0) 4.13 
work area 5.101 
cluster 
alternate index control block structure Vol. 2 
define (IGGOCLAL) 4.8 
switch to next (IKQOPNNC) 4.12 
cluster catalog record 5.19 
CMS 
alter, 4th module (IGGOCLCD) 4.10 
define 
Ist module (IGGOCLAL) 4.8 
2nd module (IGGOCLAN) 4.8 
3rd module (IGGOCLAP) 4.8 
4th module (IGGOCLBX) 4.10 
5th module (IGGOCLBY) 4.10 
6th module (IGGOCLCY) 4.10 
define space (IGGOCLFQ) 4.11 
define space (part 1) IGGOCLAQ) 4.8 
define space (part 2) (IGGOCLA6) 4.9 
delete (IGGOCLCX) 4.10 
delete (part 2) (IGGOCLA7) 4.9 
delete space (1st module) (IGGOCLBL) 4.9 
delete space (2nd module) (IGGOCLCL) 4.10 
driver (IGGOCLAT)) 4.8 
combination names in field name dictionary 5.50 
example (figure) 5.51 
Command Control Block (CCB) (see IORB) Vol. 2 
common exit ($$BCVS02) 4.13 
complete define of an entry (IGGOCLAK) 4.8 
component index 4.4 
console file, DTF (IKQDCN) 4.12 
control area 
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description 5.4 
format data (IKQPFO00) 4.12 
get new (IKQNCAO00) Vol. 2 
split (IKQCAS00) Vol. 2 and Vol. 2 
control block structure 
base cluster to alternate index Vol. 2 
multiple string Vol. 2 
control block 
directory 4.18 
generate a new (IKQGEN) 4.12 
manipulation macros 3.3 
modify, display or test IKQTMS) 4.13 
structures 5.60, 5.61, 5.62, 5.63 
control blocks, description and format 
ACB 5.64 
AMBL 5.70 
AMCBS 5.73 
AMDSSB 5.73 
AMDTFE 5.78 
ARDB Vol. 2 
BCB Vol. 2 
BHD Vol. 2 
BKPHD Vol. 2 
BSPH Vol. 2 
BVRPPL 5.81 
CAXWA 5.82 
CCA 5.84 
CCB (see IORB) Vol. 2 
CCW Vol. 2 
CCW skeletons Vol. 2 
CIW Vol. 2 
close work area 5.101 
CTGFL 5.96 
CTGFV 5.97 
CTGPL 5.99 
CWS Vol. 2 
DADSM Parameter List 5.104 
DDRW Vol. 2 
DTFIS 5.105 
EDB 5.108 
EXCPAD Parameter List Vol. 2 
EXLST Vol. 2 
FCDB Vol. 2 
FXL Vol. 2 
IOARG Vol. 2 
IODRB Vol. 2 
IORB Vol. 2 
IOWKA Vol. 2 
LPMB Vol. 2 
OAL 5.110 
OPNWA 5.111 
PLH Vol. 2 
RPHD Vol. 2 
RPL 5.119 
RSCB Vol. 2 
SHRW Vol. 2 
THB Vol. 2 
USB Vol. 2 
VSRT 5.122 
control interval 
definition field (CIDF) 5.2 
description 5.1 
format index (IKQPFO00) 4.12 
scan (IKQSCN) Vol. 2 
space reclamation (IKQCIR) Vol. 2 
split IKQCIS00) Vol. 2 and Vol. 2 
work area (CIW) Vol. 2 
control record (CCR) 5.28 
CPL (see also CTGPL) 5.99 
scan (IGGOCLAY) 4.9 
CRA (see catalog recovery area) 
CTGFL (Field Parameter List) 5.96 
CTGFV (Field Vector Table) 5.97 
CTGPL (Catalog Parameter List) 5.99 
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CWS (CCW Skeleton DSECT) Vol. 2 


DADSM Parameter List 5.104 
allocate data spaces (IKQALL00) 4.11 
build VTOC labels (IKQPOPO00) 4.12 
parameter list 5.104 
read VTOC labels (IKQRDSO00) 4.13 
rename (IKQRENO0) 4.13 
scratch VTOC labels (IKQSCRO0) 4.13 
VTOC labels (IKQWDS00) 4.13 
write VTOC labels (IKQWDS00) 4.13 
data and index entries, define and build (IGGOCLAJ) 4.8 
data areas 
alternate index 5.10 
catalog 5.11 
catalog recovery area 5.14 
control blocks 5.60 
directory 4.18 
index 5.5 
data catalog record 5.21 
data control area, format (IKQPFO00) 4.12 
data set 
control area 5.4 
control interval 
definition field 5.2 
description and format 5.1 
description 5.1 
directory entry group occurrence 5.47 
information in catalog, locate (IKQOPNHC) 4.12 
information, derived 5.47 
non-VSAM, define (IGGOCLBH) 4.9 
record 
definition field 5,2 
description and format 5.1 
rename (IKQRENO0) 4.13 
reset reusable (IKQOPNRD) 4.12 
VSAM 5.1 
data space 
allocate (IKQALLO00) 4.11 
define (IGGOCLAQ) 4.8 
delete (IGGOCLBL) 4.9 
group occurrence 5.46 
DDRW (Duplicate Data Recovery Work Area) Vol. 2 
dedicate VSAM volume label processing 
(part 1) (IGGOCLFD) 4.11 
dedicate VSAM volume label processing 
(part 2) (IGGOCLFE) 4.11 
define 
alternate index (IGGOCLCA) 4.10 
and build data and index entries (IGGOCLAJ) 4.8 
catalog open and build (IGGOCLAE) 4.8 
clean up (IGGOCLA8) 4.9 
CMS 
Ist module (IGGOCLAL) 4.8 
2nd module (IGGOCLAN) 4.8 
3rd module (IGGOCLAP) 4.8 
4th module (IGGOCLBX) 4.10 
Sth module (IGGOCLBY) 4.10 
6th module (IGGOCLCY) 4.10 
CRA 
Ist module (IGGOCLCR) 4.10 
2nd module (IGGOCLCS) 4.10 
non-VSAM data set (IGGOCLBH) 4.9 
of an entry, complete (IGGOCLAK) 4.8 
path (IGGOCLCP) 4.10 
space recovery (IGGOCLB8) 4.10 
space, catalog (IGGOCLAQ) 4.8 
space, part 2 (CMS) (IGGOCLA6) 4.9 
the file indexed sequential table (DTFIS) 5.105 
definition processing, VSAM catalog (IGGOCLA6) 4.9 
delete/build JIBs for VSAM ($$BOVS03) 4.13 
delete/insert (modify) (IGGOCLBW) 4.10 
delete 
(IGGOCLBG) 4.9 
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AIX (IGGOCLBG) 4.9 
catalog (IGGOCLAF) 4.8 
CMS (IGGOCLCX) 4.10 
part 2, CMS (IGGOCLA7) 4.9 
path (IGGOCLBG) 4.9 
space (IGGOCLBL) 4.9 
space, CMS 2nd module (IGGOCLCL) 4.10 
VSAM Resource Pool-DLVRP (IKQDRP) 4.12 
deleted CRA, mark ($$BCLCRA) 4.13 
derived data set information 5.47 
derived data space information 5.47 
device name table (IKQDNT) 4.12 
device type routine (IKQVDTPE) 4.13 
diagnostic aids Vol. 2 
CCA save area 6.19 
enable and disable (IKQVEDA) 4.13 
I/O routine for ($$BCVS04) 4.13 
error code-to-module relationships 
catalog management 6.19 
CLOSE and TCLOSE 6.36 
control block manipulation 6.31 
DADSM 6.30 
OPEN 6.32 
record management Vol. 2 
error-to-module relationships 
BLDVRP and DLVRP 6.38 
SHOWCAT 6.37 
module-to-macro relationships 
catalog and DADSM 6.9 
IIP, CBM, open/close, service aids 6.13 
record management and EOV Vol. 2 
diagnostic information, using UPSI to obtain 6.49 
directories 
component index 4.4 
control block 4.18 
IIP phase-to-module index 4.3 
module 4.7 
routine 4.14 
VSAM phase-to-module index 4.1 
disabling snap dumps 6.45 
display a control block (SHOWCB) (IKQTMS) 4.13 
display catalog information (SHOWCAT) (IKQSCAT) 4.13 
DLVRP (IKQDRP) 4.12 
do primary allocation for dynamic data set (IKQOPNDS) 4.12 
driver 
catalog (IGGOCLAB) 4.8 
CMS (IGGOCLAT) 4.8 
VSAM request (IKQVSM) 4.13 
DSA CLOSE interface function (IKQCLIF) 4.11 and Vol. 2 
DSCBs (see VTOC labels) 
DTF console file IKQDCN) 4.12 
DTFIS (Define The File Indexed Sequential table) 5.105 
dum 
block (IKQDUMP) 4.12 
catalog control blocks (IKQDUMPC) 4.12 
snap 
disabling 6.45 
enabling 6.45 
obtaining 6.46 
testing if required 6.49 
Duplicate Data Recovery Work Area (DDRW) Vol. 2 


EDB (extent definition block) 5,108 
chain, summarize JIBs for (IKQJIBSM) 4.12 
extend (IKQEDX) 4.12 
enable and disable VSAM diagnostic aids (IKQVEDA) 4.13 
enabling snap dumps 6.45 
end of message interface ($$BODADE) 4.13 
enter index (IKQIXE) Vol. 2 
entry 
field name dictionary 5.48 
index 5.8 
point directory 4.14 
section 5.9 
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translation, volume (IGGOCLBS) 4.9 
ERASE (IKQMDY) Vol. 2 and Vol. 2 
error 

exit (IKQERX) 4.12 

handler (IKQERH) 4.12 
error code-to-module relationships 

BLDVRP 6.38 

catalog management 6.19 

CLOSE and TCLOSE 6.36 

control block manipulation 6.31 

DADSM 6.30 

DLVRP 6.38 

OPEN 6.32 

record management Vol. 2 

SHOWCAT 6.37 
evaluation, AIX (IKQCLOVY) 4.12 
EXCPAD parameter list Vol. 2 
exit 

common ($$BCVS02) 4.13 

error (IKQERX) 4.12 

JRNAD (IKQJRN) Vol. 2 

list (EXLST) Vol. 2 
extend EDB (IKQEDX) 4.12 
extension catalog record 5.24 
extent 

block (see JIB) ° 

definition block (see EDB) 

get new (IKQNEX) 4.12 

manage space within (IKQSPMO00) Vol. 2 

open volume (IKQOPNOV) 4.12 
extract catalog field (IGGOCLAZ) 4.9 
extract volume information from default 
model (IGGOCLFC) 4.11 


FBA I/O manager (IKQIOC) Vol. 2 
FCDB (field control and data block) Vol. 2 
feature indicator (IKQFTIND) 4.12 
field 
control and data block (FCDB) Vol. 2 
extract catalog (IGGOCLAZ) 4.9 
modify catalog (IGGOCLAV) 4.9 
name directory 
combination names in 5.51 
description and format 5.48 
examples 5.58 
parameter list (CTGFL or FPL) 5.96 
vector table (CTGFV or FVT) 5.97 
file sharing control (IKQOCSHR) 4.12 
file sharing work area (SHRW) for SHAREOPTIONS (4) Vol. 2 
Fix List (FXL) Vol. 2 
flowcharts, program 3.16 
format 
data CA or index CNV (IKQPFO00) 4.12 
index (IKQIXF) Vol. 2 
of catalog records 5.16 
of control blocks 5.60 
FPL (field parameter list) 5.96 
free 
catalog record 5,26 
data-control-interval pointer 5.8 
FREEBUFF (IKQBFA) 4,11 
FVT (Field Vector Table) 5.97 
FXL (Fix List) Vol. 2 
F4 VTOC label, catalog read/write IGGOCLBU) 4.10 


GENCB: Build a new control block (IKQGEN) 4.12 
generate partition/processor independent 
name (IGGOCLFA) 4.11 
generate volume list from default 
model (IGGOCLFB) 4.11 
get 
backwards function (IKQLCP) Vol. 2 
CI (IKQGCI) Vol. 2 
new control area (IKQNCA00) Vol. 2 
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new extent (IKQNEX) 4,12 
next buffer and read ahead (IKQGNX00) Vol. 2 
spanned record (IKQSRG) Vol. 2 
GET PREVIOUS (IKQLCP) Vol. 2 
get/point (IKQGPT) Vol. 2 
GETBUFF (IKQBFA00) 4.11 
GETNXT (IKQGNX00) Vol. 2 
group occurrence 
add (modify) (IGGOCLAW) 4.9 
description 5.37 
format and description 
AMDSB 5.42 
association information 5.43 
data set directory entry 5.47 
data space 5.46 
password information 5.45 
space map 5.45 
volume information 5.43 
in extension records 5.38 


header, index record 5.7 
high key range of catalog 
(see also low key-range of catalog) 
description 5.13 
relationship to other parts of catalog (figure) 5.12 
true-name catalog record 5.16 


I/O Driver Block (IODRB) Vol, 2 
I/O management Vol. 2 
I/O manager 
(IKQIOA) Vol. 2 
EXCP/WAIT (IKQIOD) Vol. 2 
FBA (IKQIOC) Vol. 2 
I/O error analysis IKQIOB) Vol. 2 
1/O Request Block (IORB) Vol. 2 
I/O routine for IKQVEDA ($$BCVS04) 4.13 
I/O subfunctions, catalog (IGGOCLAG) 4.8 
I/O subroutine (2nd module), VSAM catalog (IGGOCLCG) 4.10 
I/O Work Area (IOWKA) 8,2 
IIP (see ISAM interface program) 
IKQVDU service aid 6.51 
IKQVDUMP service aid 6.46 
index 
alternate 5.10 
catalog record 5.21, 5.27 
component 4.4 
control interval, format (IKQPFO00) 4.12 
create entry (IKQIXE00) Vol. 2 
description 5.5 
enter (IKQIXE) Vol. 2 
entry 5.8 
entry section 5.9 
example (figure) 5.5 
format (IKQIXF) Vol. 2 
phase-to-module 4.1 
record 5.5 
record header 5.7 
routine 4.14 
search (IKQIXS) Vol. 2 
sequence set 5.5 
set 5.5 
insert IKQSRT) Vol. 2 
IOARG (I/O Arguments) Vol. 2 
IODRB (I/O Driver Block) Vol. 2 
IORB (I/O Request Block) Vol. 2 
IOWKA (I/O Work Area) Vol. 2 
ISAM interface program (IIP) 
$$B message routine (IIPBMR00) 4.11 
close (IIPCLS00) 4.11 
control block (IIPAMTO00) 4.11 
open (IIPOPN00) 4.11 
phase-to-module index 4.3 
processor, messages (IIPPRCMR) 4.11 
processor, processing (IIPPRCPR) 4.11 
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JIBs 
delete/build for VSAM ($$BOVS03) 4.13 | 
summarize for EDB chain (IKQJIBSM) 4.12 
JRNAD exit (IKQJRN) Vol. 2 
in EXLST Vol. 2 


key range determination routine (IKQKRD) Vol. 2 
key ranges of catalog 5.13 

interrelationships (figure) 5.12 
KSDS control block structure 5.60 


label area, look at (IKQLAB) 4.12 
LISTCAT processing (IGGOCLBQ) 4.9 
LKMOD routine ($$BCVS03) 4.13 
loading a VSAM phase or program you have written 6.56 
locate 
catalog information (IGGOCLAZ) 4.9 
data set information in catalog (IKQOPNHC) 4.12 
direct (IKQLCD) Vol. 2 
next (IKQLCN) Vol. 2 
next by argument (IKQLNA) Vol. 2 
previous (IKQLCP) Vol. 2 
locks, VSAM use of 6.2 and Vol. 2 
Logical-to-Physical Mapping Block (LPMB) Vol. 2 
look at label cylinder (IKQLAB) 4.12 
low key range of catalog 
(see also high-key range of catalog) 
catalog records in 5.13 
alternate index 5.27 
cluster 5.19 
control (CCR) 5.28 
data 5.21 
extension 5.24 
free 5.26 
index 5.28 
non-VSAM 5.17 
path 5.30 
upgrade set 5.36 
user-catalog 5.32 
volume 5.33 
volume extension 5.35 
description 5.11 
relationship to other parts of catalog (figure) 5.12 
LPMB (Logical-to-Physical Mapping Block) Vol. 2 
LSR buffer management (IKQBFB) 4.11 


macro-to-module relationships 6.4 and Vol. 2 
catalog and DADSM modules 6.9 
IIP, CBM, open/close, service aids 6.13 
record management and EOV Vol. 2 
maintaining VTOC and VOL] labels 6.51 
maintenance utility, VTOC (IKQCLEAN) 4.11 
manage space within extents (IKQSPMO00) Vol. 2 
manager 
buffer (IKQBFA00) Vol. 2 
I/O (IKQIOA) Vol. 2 
mark deleted CRA ($$BCLCRA) 4.13 
master catalog 
open (IGGOCLAD) 4.8 
search (IGGOCLAC) 4.8 
message routine 
$$B (IIPBMRO0) 4.11 
open/close (IKQOCMSG) 4.12 
Method of Operation diagrams 2.1 
reading 2.1 
symbols used 2.2 
MODCB, SHOWCB, TESTCB: Modify, display, or test a 
control block (IKQTMS) 4.13 
modify (IKQMDY) Vol. 2 
a control block (MODCB) (IKQTMS) 4.13 
catalog field (IGGOCLAV) 4.9 
control interval (IKQMDY) Vol. 2 
volume entry translation (IGGOCLBT) 4.10 
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module 


$$BACLOS 4.13 
$$BCLCRA 4.13 
$$BCVSAM 4.13 
$$BCVS02 4.13 
$S$BCVSO03 4.13 
$$BCVS04 4.13 


$$BODADE 4.13 and Vol. 2 


$$BODADS 4.13 


$SBOVSAM 4.13 and Vol. 2 
$$BOVSO1 4.13 and Vol. 2 


$$BTCLOS 4.13 
$SVAVSAM 4.13 


-to-phase index, IIP 4.3 
-to-phase index, VSAM 4.1 


directory 4.9 
IGGOCLAB 4.8 
IGGOCLAC 4.8 
IGGOCLAD 4.8 
IGGOCLAE 4.8 
IGGOCLAF 4.8 
IGGOCLAG 4.8 
IGGOCLAH 4.8 
IGGOCLAJ 4.8 
IGGOCLAK 4.8 
IGGOCLAL 4.8 
IGGOCLAN 4.8 
IGGOCLAP 4.8 
IGGOCLAQ 4.8 
IGGOCLAR 4.8 
IGGOCLAS 4.8 
IGGOCLAT 4.8 
IGGOCLAU 4.8 
IGGOCLAV 4.9 
IGGOCLAW 4.9 
IGGOCLAX 4.9 
IGGOCLAY 4.9 
IGGOCLAZ 4.9 
IGGOCLA6 4.9 
IGGOCLA7 4.9 
IGGOCLA8 4.9 
IGGOCLBA 4.9 
IGGOCLBB 4.9 
IGGOCLBC 4.9 
IGGOCLBD 4.9 
IGGOCLBE 4.9 
IGGOCLBF 4.9 
IGGOCLBG 4.9 
IGGOCLBH 4.9 
IGGOCLBL 4.9 
IGGOCLBM 4.9. 
IGGOCLBN 4.9 
IGGOCLBQ 4.9 
IGGOCLBR 4.9 
IGGOCLBS 4.9 
IGGOCLBT 4.10 
IGGOCLBU 4.19 
IGGOCLBW 4.10 
IGGOCLBX 4.10 
IGGOCLBY 4.10 
IGGOCLB8 4.10 
IGGOCLCA 4.10 
IGGOCLCB 4.10 
IGGOCLCD 4.10 
IGGOCLCG 4.10 
IGGOCLCL 4.10 
IGGOCLCO 4.10 
IGGOCLCP 4,10 
IGGOCLCR 4.10 
IGGOCLCS 4.10 
IGGOCLCX 4.10 
IGGOCLCY 4.10 
IGGOCLC9 4.10 
IGGOCLEG 4.10 
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IGGOCLES 4.11 
IGGOCLET 4.11 
IGGOCLEX 4.1! 
IGGUCLEZ 4.11 
IGGOCLFA 4.11 
IGGOCLEB 4.11 
IGGOCLFC 4.11 
IGGOCLED 4.11 
IGGOCLFE 4.11 
IGGOCLFF 4.11 
IGGOCLFH 4.11 
IGGOCLFQ 4.11 
IIPAMT00 4.11 
IIPBMROO 4.11 
IIPCLS00 4.11 

IIPIIPOO 4.11 

IIPOPN00 4.11 
IIPPRCMR 4.11 
IIPPRCPR 4.11 
IKQAIX Vol. 2 
IKQALLO0 4.11 
IKQASNMT 4.11 
IKQBFA0O 4.11 and Vol. 2 
IKQBFBO0 4.11 and Vol. 2 
IKQBFCOO Vol. 2 
IKQBFD Vol. 2 
IKQBLD Vol. 2 
IKQBRP 4.11 
IKQCAS00 Vol. 2 
IKQCIL Vol. 2 

IKQCIR Vol. 2 
IKQCISO00 4.11 and Vol. 2 
IKQCIU Vol. 2 
IKQCLCAT 4.11 and Vol. 2 
IKQCLEAN 4.11 
IKQCLIF 4.11 and Vol. 2 
IKQCLNLK 4.12 
IKQCLO 4.12 
IKQCLOCL 4.12 
IKQCLOVY 4.12 
IKQCLRDD 4.12 
IKQDCN 4.12 
IKQDDR Vol. 2 
IKODNT 4.12 

IKQDRP 4.12 
IKQDUMP 4.12 
IKQDUMPC 4.12 
IKQEDX 4.12 and Vol. 2 
IKQEOV 4.12 and Vol. 2 
IKQERH 4.12 and Vol. 2 
IKQERX 4.12 and Vol. 2 
IKQFIND 4.12 

IKQFT1 4.12 

IKQFT2 4.12 

IKQFT3 4.12 

IKQGCI Vol. 2 
IKQGEN 4.12 
IKQGNX00 Vol. 2 
IKQGPT Vol. 2 
IKQINT Vol. 2 
IKQIOA Vol. 2 

IKQIOB Vol. 2 

IKQIOC Vol. 2 
IKQIOD Vol. 2 
IKQIXE00 Vol. 2 
IKQIXFO00 Vol. 2 
IKQIXS00 Vol. 2 
IKQJIBSM 4.12 and Vol. 2 
IKQJRN Vol. 2 
IKQKRD Vol. 2 
IKQLAB 4.12 

IKQLCD Vol. 2 
IKQLCN Vol. 2 
IKQLCP Vol. 2 
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IKQLNA Vol. 2 
IKQMDY Vol. 2 
IKQMTMSG 4.12 
IKQNCAO0 Vol. 2 
IKQNEX 4.12 and Vol. 2 
IKQOCIMR 4.12 
IKQOCMSG 4.12 and Vol. 2 
IKQOCSHR 4.12 
IKQOPN 4.12 
IKQOPNAB 4.12 
IKQOPNAI 4.12 
IKQOPNCT 4.12 
IKQOPNDO 4.12 
IKQOPNDS 4.12 
IKQOPNHC 4.12 
IKQOPNNC 4.12 
IKQOPNOV 4.12 
IKQOPNPV 4.12 
IKQOPNRD 4.12 
IKQOPNRP 4.12 
IKQOPNUC 4.12 
IKQOPNUS 4.12 
IKQOPNVC 4.12 
IKQPBF00 Vol. 2 
IKQPFO00 4.12 
IKQPOPO00 4.12 
IKQRBA 4.12 and Vol. 2 
IKQRCLOO0 4.13 and Vol. 2 
IKQRDS00 4.13 
IKQRENOO0 4.13 
IKQRQA 4.13 and Vol. 2 
IKQRQB 4.13 and Vol. 2 
IKQRQC 4.13 and Vol. 2 
IKQRRP Vol. 2 
IKQRTV Vol. 2 
IKQSCAT 4.13 
IKQSCN Vol. 2 
IKQSCRO00 4.13 
IKQSFT 4.13 and Vol. 2 
IKQSGP Vol. 2 
IKQSIN Vol. 2 
IKQSLD Vol. 2 
IKQSLN Vol. 2 
IKQSLP Vol. 2 
IKQSMACL 4.13 
IKQSPMO00 Vol. 2 
IKQSRG Vol. 2 
IKQSRT Vol. 2 
IKQSRU Vol. 2 
IKQSTM 4.13 

IKQSUP Vol. 2 
IKQTMSD 4.13 
IKQTMSF 4.13 
IKQUPD Vol. 2 
IKQUPG Vol. 2 
IKQVDTPE 4.13 
IKQVEDA 4.13 
IKQVFY Vol. 2 
IKQVSM 4.13 and Vol. 2 
IKQVSMLK 4.13 
IKQVTC00 4.13 
IKQWDS00 4.13 
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mount volume and assign a logical unit IKQASNMT) 4.11 
mount 


volume (IKQEOV) 4.12 
volume, catalog/DADSM interface to ($$BOVSO1) 4.13 
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new extent, get (IKQNEX) 4.12 
next cluster IKQOPNNC) 4.12 
nonVSAM 
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data set, define (IGGOCLBH) 4.9 
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O/C message writer with operator reply IKQMTMSG) 4.12 
open catalog (IKQOPNCT) 4.12 
open/close 
message routine (IKQOCMSG) 4.12 
VTOC (IKQVTC00) 4.13 
open 3.4 
ACB list (OAL) 5.110 
catalog recovery area (IGGOCLCO) 4.10 
failure, clean up after (IKQOPNDO) 4.12 
function (IKQOPN) 4.12 
IIP (IIPOPNO00) 4.11 
interface ($$BOVSAM) 4.13 
master catalog (IGGOCLAD) 4.8 
volume extent (IKQOPNOV) 4.12 
work area (OPNWA) 5.111 
OPN WA (Open Work Area) 5.111 
origin for VSAM volume (IGGOCLFF) 4.11 
overview 
buffer management Vol. 2 
control area split Vol. 2 
control block manipulation 3.3, 5.60 
control interval split Vol. 2 
ERASE Vol. 2 
GET Vol. 2 
I/O management Vol. 2 
POINT Vol. 2 
PUT Vol. 2 
VERIFY Vol. 2 


password check (IGGOCLBM) 4.9 
password group occurrence 5.45 
path 
catalog record 5.30 
define (IGGOCLCP) 4.10 
delete (IGGOCLBG) 4.9 
processing (IKQAIX) Vol. 2 
phase 
and include statements (IKQCLNLK) 4.12 
and include statements (IKQVSMLK) 4.13 
and include statements, IIP (IIPIIPO0) 4.11 
to-module index 
IIP 4.3 
VSAM 4.1 
Placeholder (PLH) Vol. 2 
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PLH initialization for LSR (IKQINT) Vol. 2 
POINT Vol. 2 
point/get (IKQGPT) Vol. 2 
pointer, free data-control-interval 5.8 
preformat relative record data set IKQRRP) Vol. 2 
processor 
messages, IIP (IIPPRCMR) 4.11 
processing, IIP (IIPPRCPR) 4.11 
Program organization 3.1 
flowcharts 3.16 
structures 3.2 
symbols used in 3.2 
prologues 
module 3.1 
routine 3.2 
purge buffer (IKQPBF) Vol. 2 
PUT Vol. 2 
PUT ADD (IKQSRT) Vol. 2 
PUT LOCATE,ISAM (IKQUPD) Vol. 2 
PUT UPDATE (IKQUPD) Vol. 2 


RBA conversion (IKQIOA) Vol. 2 
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build (IKQBLD) Vol. 2 
read VTOC labels (IKQRDS00) 4.13 
read/write F4 VTOC label, catalog IGGOCLBU) 4.10 
record 
alternate index 5.10 
catalog (see catalog records) 
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data 5.1 
definition field 5,2 
index 5.5 
record management 
alternate index upgrade (IKQUPG) Vol. 2 
buffer manager (IKQBFA) Vol. 2 
catalog update (IKQRBA) Vol. 2 
close (IKQRCLO00) Vol. 2 
control interval split IKQCIS00) Vol. 2 
ERASE (IKQMDY) Vol. 2 
error handling (IKQERH) Vol. 2 
extend EDB (IKQEDX) Vol. 2 
format data CA or index CNV (IKQPFO00) Vol. 2 
GET (IKQGPT) Vol. 2 
get new control area (IKQNCA00) Vol. 2 
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GET PREVIOUS (IKQLCP) Vol. 2 
GETNXT (IKQGNX00) Vol. 2 
I/O manager (IKQIOA) Vol. 2 
index entry, create (IKQIXE00) Vol. 2 
index format (IKQIXF00) Vol. 2 
index search (IKQIXS00) Vol. 2 
JRNAD exit (IKQJRN) Vol. 2 
LOCATE DIRECT (IKQLCD) Vol. 2 
LOCATE NEXT (IKQLCN) Vol. 2 
LOCATE NEXT BY ARGUMENT (IKQLNA) Vol. 2 
LOCATE PREVIOUS (IKQLCP) Vol. 2 
modify data control interval (IKQMDY) Vol. 2 
mount volume (IKQEOV) Vol. 2 
path processing (IKQAIX) Vol. 2 
POINT (IKQGPT) Vol. 2 
preformat RRDS (IKQRRP) Vol. 2 
purge buffer (IKQPBF) Vol. 2 
PUT ADD (IKQSRT) Vol. 2 
PUT LOCATE (IKQUPD) Vol. 2 
PUT UPDATE (IKQUPD) Vol. 2 
RDFs (IKQBLD) Vol. 2 
retrieve spanned records (IKQSRG) Vol. 2 
scratch buffer (IKQBFB) Vol. 2 
space within extents (IKQSPMO00) Vol. 2 
split control area (IKQCAS00) Vol. 2 
store spanned records (IKQSRG) Vol. 2 
VERIFY (IKQVFY) Vol. 2 
write buffers IKQBFBO00) Vol. 2 
relative record preformat (IKQRRP) Vol. 2 
release function (IGGOCLCB) 4.10 
rename data set (IKQRENO00) 4.13 
request 
analyzer | (IKQRQA) 4.13 
analyzer 2 (IKQRQB) 4.13 
analyzer 3 (IKQRQC) Vol. 2 
driver, VSAM (IKQVSM) 4.13 
parameter list (RPL) Vol. 2 
reset reusable data set (IKQOPNRD) 4.12 
Resource Pool Header (RPHD) Vol. 2 
Resource Sharing Control Block (RSCB) Vol. 2 
retrieve (IKQRTV) Vol. 2 
reusable data set, reset IKQOPNRD) 4.12 
routine 
directory 4.14 
prologues 3.2 
RPHD (Resource Pool Header) Vol. 2 
RPL (Request Parameter List) 5.119 
RSCB (Resource Sharing Control Block) Vol. 2 


save area, CCA 6.19 
scan 
control interval (IKQSCN) Vol. 2 
CPL (IGGOCLAY) 4.9 
scratch VTOC labels (IKQSCRO00) 4.13 
search catalog (IGGOCLFH) 4.11 
search 
catalog (IGGOCLAH) 4.8 
index (IKQIXS) Vol. 2 
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master catalog (IGGOCLAC) 4.8 
sequence set, index 5.5 
service aids 
enabling and disabling snap dumps 6.45 
IKQVDU 6.51 
IKQVDUMP 6.46 
testing if dump required 6.49 
loading a VSAM phase or program you have written 6.56 
maintaining DSCBs and VOLI labels (IKQVDU) 6.51 
obtaining snap dumps 6.46 
using UPSI to obtain diagnostic information 6.49 
Shared Resource Table VSAM (VSRT) 5.122 
shift IKQSFT) 4.13 
SHOWCAT (IKQSCAT) 4.13 
SHOWCB: display a CB (IKQTMS) 4.13 
SHRW (file sharing work area) for SHAREOPTIONS (4) Vol. 2 
snap dumps 
disabling 6.45 
enabling 6.45 
IKQVDUMP 6.46 
obtaining 6.46 
sort volume entries (IKQOPNPV) 4.12 
space allocation (IGGOCLET) 4.11 
Space management feature (IKQFT1) 4.12 
space 
delete (IGGOCLBL) 4.9 
map group occurrence 5.45 
reclamation routine, control interval (IKQCIR) Vol. 2 
recovery, define (IGGOCLB8) 4.10 
within extents, manage (IKQSPMO00) Vol. 2 
spanned record 
get (IKQSRG) Vol. 2 
index entries 5.8 
store (IKQSRU) Vol. 2 
update (IKQSRU) Vol. 2 
split 
control area (IKQCAS00) Vol. 2 
control interval (IKQCIS00) 4.11 
start of message interface ($$BODADS) 4.13 
storage management (IKQSTM) 4.13 
structures, program 3.2 
suballocate (IGGOCLAR) 4.8 
suballocate bit mask handler (IGGOCLBR) 4.9 
suballocation (IGGOCLAUV) 4.8 
subscratch (IGGOCLBF) 4.9 
summarize JIBs for EDB chain (IKQJIBSM) 4.12 
SVA module list $9SVAVSAM) 4.13 and Vol. 2 


TCLOSE 3.13 

TCLOSE interface ($$BTCLOS) 4.13 

test a control block (TESTCB) (IKQTMS) 4.13 

test catalog field values (IGGOCLBA) 4.9 

testing if a dump is required 6.49 

THB (The Hold Block) for SHAREOPTIONS (4) Vol. 2 
The Hold Block (THB) for SHAREOPTIONS (4) Vol. 2 
track hold control (IKQBFC) Vol. 2 
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track-to-block translation (IGGOCLEZ) 4.11 
translation, volume entry (IGGOCLBS) 4.9 
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update (IKQUPD) Vol. 2 

extend (IGGOCLBB) 4.9 

extend initialization (IGGOCLBC) 4.9 
update catalog for sharing (IKQRBA) 4.12 
update spanned record (IKQSRU) Vol. 2 
upgrade routine, AIX (IKQUPG) Vol. 2 
upgrade set 

block (USB) Vol. 2 

catalog record 5.36 

determination (IKQOPNUS) 4.12 
UPSI, using to obtain diagnostic information 6.49 
USB (Upgrade Set Block) Vol. 2 
use of locks, VSAM 6.2 and Vol. 2 
user catalog (IKQOPNUS) 4.12 
user-catalog catalog record 5.32 


VERIFY (IKQVFY) Vol. 2 and Vol. 2 
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alter processing (IGGOCLBE) 4.9 
catalog record 5.33 
catalog/DADSM interface to mount ($$BOVSO1) 4.13 
entry translation (IGGOCLBS) 4.9 
entry translation, modify (IGGOCLBT) 4.10 
extension catalog record 5.35 
extent, open (IKQOPNOV) 4.12 
information group occurrence 5.43 
mount (IKQEOV) 4.12 
VOL] labels, maintaining 6.51 
VSAM catalog definition processing (IGGOCLES) 4.11 
VSAM data set 5.1 
VSAM use of locks 6.2 and Vol. 2 
VSE/VSAM space management for SAM feature 
(IKQOCIMR) 4.12 
(IKQOPNVC) 4.12 
(IKQSMACL) 4.13 
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maintaining 6.51 
open/close (IKQVTCO00) 4.13 
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scratch (IKQSCRO00) 4.13 
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International Business Machines Corporation 
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Town of Mount Pleasant, Route 9, North Tarrytown, N. Y., U.S. A. 10591 
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